Use a verificação de imagem durante a criação ou importação para validar uma imagem. - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Nota

Criar ou importar uma imagem aciona automaticamente uma verificação. Esse processo não interrompe o fluxo de trabalho, mesmo em caso de falha.
A verificação de imagem é gratuita.
Imagens aprovadas na verificação recebem automaticamente tags de versão do sistema operacional (acs:ecs:image:osVersion) e versão do kernel (acs:ecs:image:kernelVersion).

Limitações

A verificação de imagem suporta apenas imagens personalizadas criadas a partir de snapshots não criptografados ou de instâncias sem discos em nuvem criptografados.

A verificação de imagem não suporta alguns sistemas operacionais Linux e Windows, conforme listado nas tabelas a seguir.

Sistemas operacionais Linux não suportados

Sistema operacional	Versão
Gentoo	Gentoo 13 64-bit
	Gentoo_32
	Gentoo_64
	Gentoo_arm64
Aliyun	LifseaOS 10 64-bit
	LifseaOS 3 64-bit
	LifseaOS 3 64-bit GPU Edition
FreeBSD	FreeBSD 10.1 64-bit
	FreeBSD 8.2 64-bit
	Freebsd_32
	Freebsd_64
	FreeBSD 11.1 64-bit
	FreeBSD 11.2 64-bit
	FreeBSD 11.3 64-bit
	FreeBSD 12.1 64-bit
	FreeBSD 11.4 64-bit
	Freebsd_arm64
	FreeBSD 13.0 64-bit
	FreeBSD 12.3 64-bit
CoreOS	CoreOS 681.2.0 64-bit
	CoreOS_32
	CoreOS_64
	CoreOS 1353.8.0 64-bit
	CoreOS 1465.8.0 64-bit
	CoreOS 1576.5.0 64-bit
	CoreOS 1688.5.3 64-bit
	CoreOS 1745.7.0 64-bit
	CoreOS 2023.4.0 64-bit
	CoreOS 2247.6.0 64-bit
	CoreOS 2303.3.0 64-bit
	CoreOS 2303.4.0 64-bit
	CoreOS 2345.3.0 64-bit
	CoreOS_arm64
Fedora CoreOS	FedoraCoreOS_64
	Fedora CoreOS 33.20210217.3.0_3
	FedoraCoreOS_arm64
	Fedora CoreOS 34.20210529.3.0_3
Solaris	Solaris 10u8 64-bit
mars	Aliyun Customized Linux
Customized Linux	CustomizedLinux_64
	CustomizedLinux_32
	CustomizedLinux_arm64

Sistemas operacionais Windows não suportados

Sistema operacional	Versão
Windows Server 2008	Windows Server 2008 Standard Edition 64-bit Chinese Edition
	Windows Server 2008 Standard Edition 64-bit English Edition
	Windows Server 2008 Standard Edition SP2 32-bit Chinese Edition
	Windows Server 2008 Enterprise Edition 32-bit Chinese Edition
	Windows Server 2008 Standard Edition SP2 32-bit English Edition
	WindowsServer2008_64
	WindowsServer2008_32
	Windows Server 2008 Standard Edition SP2 32-bit Japanese Edition
Windows Server 2003	Windows Server 2003 R2 Standard Edition SP2 64-bit Chinese Edition
	Windows Server 2003 R2 Standard Edition SP2 32-bit Chinese Edition
	Windows Server 2003 R2 Standard Edition SP2 64-bit English Edition
	Windows Server 2003 R2 Enterprise Edition 64-bit English Edition
	Windows Server 2003 R2 Enterprise Edition 64-bit Chinese Edition
	Windows Server 2003 R2 Enterprise Edition 32-bit Chinese Edition
	WindowsServer2003_64
	WindowsServer2003_32
Windows 7	Windows7_32
Windows 8	Windows8_32
Windows 10	Windows10_32

Configurar a verificação de imagem

Durante a criação da imagem

Console

Ao criar uma imagem personalizada no console ECS, a verificação de imagem é executada por padrão. Nenhuma alteração é necessária. Para mais informações, consulte Criar uma imagem personalizada usando uma instância e Criar uma imagem personalizada usando um snapshot.

API

Defina o parâmetro DetectionStrategy=Standard chamando a operação CreateImage. Execute essa operação no OpenAPI Explorer para evitar o cálculo manual de assinaturas e gerar automaticamente exemplos de código SDK.

Durante a importação da imagem

Console

Ao importar uma imagem personalizada no console ECS, a verificação de imagem é executada por padrão. Nenhuma alteração é necessária. Para mais informações, consulte Importar uma imagem personalizada.

API

Defina o parâmetro DetectionStrategy=Standard na operação ImportImage. Execute essa operação no OpenAPI Explorer para evitar o cálculo manual de assinaturas e gerar automaticamente exemplos de código SDK.

Resultados da verificação de imagem

Console

Na página Custom Images, localize a imagem criada. Uma tarefa de verificação de imagem inicia automaticamente assim que o status da imagem mudar para Available.
Passe o mouse sobre o resultado da verificação e clique em View Details para visualizar os detalhes. Após a conclusão da verificação, a coluna Check Result exibe o status. Ao passar o mouse sobre o resultado, você vê a quantidade de itens Critical, Suggested e Passed. Clique em View Details para acessar o relatório completo.
Se houver itens que necessitem de correção, siga as recomendações apresentadas.
- (Exclusivo para imagens Linux) Clique em Fix e use o modelo público ACS-ECS-RepairImage no CloudOps Orchestration Service (OOS) para corrigir os problemas.
- Como alternativa, corrija os problemas manualmente seguindo as recomendações nos detalhes da imagem. Para obter informações sobre os itens de verificação e as correções sugeridas, consulte Itens de verificação de imagem e sugestões de reparo.
A página de resultados categoriza os itens em três tipos: itens sem riscos encontrados, correções críticas e otimizações recomendadas. Cada categoria lista os itens específicos e fornece links para correções ou otimizações.

API

Chame a operação DescribeImages e use o ID da imagem para consultar os resultados. Execute essa operação no OpenAPI Explorer. Essa ferramenta simplifica o processo ao gerenciar cálculos de assinatura e gerar exemplos de código SDK automaticamente.

Nota

Na resposta, DetectionOptions contém os resultados da detecção, Status indica o status da tarefa e Item traz o resultado de cada item verificado.

Verificações e correções de imagem

Linux

Item de verificação	Descrição	Correção recomendada
GUESTOS.Platform	Plataforma do sistema. Deve ser um sistema operacional Linux.	Não aplicável
GUESTOS.OSVersion	Versão do sistema operacional.	Não aplicável
GUESTOS.Architecture	Arquitetura do sistema.	Não aplicável
GUESTOS.RtcTimeMode	Define o fuso horário do relógio de hardware (RTC) da imagem. Os valores válidos são UTC ou local. Recomendamos configurar o relógio de hardware para UTC.	Para definir o relógio de hardware como UTC, consulte Hora e fusos horários no Linux.
GUESTOS.BootMode	Modo de inicialização da imagem. Os valores válidos são LEGACY ou UEFI.	Não aplicável
GUESTOS.KernelVersion	Versão do kernel.	Não aplicável
GUESTOS.Virtio	Verifica se o driver virtio está instalado. Instâncias ECS exigem esse driver para virtualização e podem falhar ao iniciar sem ele.	Para instalar o driver virtio em uma imagem, consulte Instalar o driver virtio.
GUESTOS.Nvme	Verifica se o driver NVMe está instalado. Certas famílias de instâncias ECS, como ecs.g7se, utilizam discos em nuvem conectados via NVMe e exigem esse driver na imagem.	Para instalar o driver NVMe em uma imagem, consulte Como instalo o driver NVMe para uma imagem personalizada existente?.
GUESTOS.Fstab	Verifica o arquivo `/etc/fstab`. Configurações incorretas, como dispositivos inexistentes ou UUIDs de dispositivo errados, podem causar falhas na inicialização do sistema.	Para configurar corretamente o `/etc/fstab`, consulte Configurar UUIDs no arquivo fstab para montar discos de dados automaticamente.
GUESTOS.Grub	Verifica a configuração do carregador de boot GRUB. Definições incorretas, como caminhos de dispositivo ou UUIDs inválidos, podem impedir a inicialização do sistema.	Nenhum
GUESTOS.Dhcp	Verifica se a rede está configurada para DHCP. O uso de endereço IP estático na imagem pode provocar falhas de rede quando a instância for iniciada.	Para definir o modo de configuração de rede da imagem como DHCP, consulte Configurar DHCP para uma instância Linux.
GUESTOS.Selinux	Verifica se o SELinux está desativado. Recomendamos desativar o SELinux em imagens de nuvem para evitar possíveis falhas de inicialização.	Para desativar o SELinux, consulte Ativar ou desativar o SELinux.
GUESTOS.OnlineResizeFS	Verifica se a imagem suporta redimensionamento automático da partição raiz. Se a imagem possuir cloud-init, o comando `growpart` e outras ferramentas necessárias instaladas, a partição raiz de uma instância criada a partir dela será expandida automaticamente. Por exemplo, ao criar uma instância com disco de sistema de 100 GB a partir de uma imagem de 20 GB, a partição raiz se expandirá para 100 GB.	Para configurar a imagem com suporte a redimensionamento automático, consulte Instalar o cloud-init.
GUESTOS.SystemImage	Verifica se a imagem é uma imagem de disco de sistema válida. Não importe imagens inválidas, como arquivos ISO ou imagens vazias.	Não aplicável
GUESTOS.CloudAssistant	Verifica se o Cloud Assistant está instalado. O Cloud Assistant é uma ferramenta nativa de automação e gerenciamento para ECS que permite executar operações em lote, rodar comandos (como Shell, powershell e Bat) e transferir arquivos em instâncias ECS sem senhas, logins ou bastion hosts. Recomenda-se a instalação do Cloud Assistant para um gerenciamento eficiente das instâncias.	Para instalar o Cloud Assistant, consulte Instalar o Agente do Cloud Assistant.
GUESTOS.CloudInit	Verifica se o cloud-init está instalado na imagem. O cloud-init é o padrão da indústria para inicialização de instâncias em nuvem, lidando com tarefas de configuração como definição de hostnames, pares de chaves SSH e redimensionamento da partição raiz.	Para instalar o cloud-init em uma imagem, consulte Instalar o cloud-init.
GUESTOS.SecurityCenterAgent	Verifica se o agente do Security Center está instalado na imagem. O Security Center é um sistema unificado de gerenciamento de segurança que oferece detecção e proteção contra ameaças em tempo real. Seus recursos incluem visão geral da postura de segurança, anti-ransomware, antivírus, anti-adulteração e verificações de conformidade para proteger integralmente seus servidores e aplicações web.	Para instalar o agente do Security Center em uma imagem, consulte Instalar o cliente.
GUESTOS.SupportMocInstanceTypes	Verifica se a imagem suporta famílias de Instâncias Bare Metal do ECS. As famílias mais recentes de instâncias ECS, como ecs.g6 e ecs.g7, frequentemente baseiam-se na arquitetura de Instância Bare Metal do ECS. Uma instância pode falhar ao iniciar nessas famílias se o sistema operacional e a versão do kernel da imagem estiverem desatualizados. Para mais informações sobre famílias de instâncias, consulte Família de instâncias.	Se você utiliza CentOS 5, recomendamos atualizar para a versão mais recente, CentOS 5.11. Para mais informações, consulte Como resolvo o tempo de inatividade da instância após a migração?. Sistemas operacionais que não suportam famílias de Instâncias Bare Metal do ECS geralmente são versões antigas e fora de linha (EOL). Recomendamos atualizar o quanto antes para uma versão de sistema operacional mantida ativamente pelo fornecedor.

Windows

Item de verificação	Descrição	Correção recomendada
GUESTOS.Platform	Plataforma do sistema. Deve ser um sistema operacional Windows.	Não aplicável
GUESTOS.OSVersion	Versão do sistema operacional.	Não aplicável
GUESTOS.Architecture	Arquitetura do sistema.	Não aplicável
GUESTOS.KernelVersion	Versão do kernel.	Não aplicável
GUESTOS.Virtio	Verifica se o driver virtio está instalado. Instâncias ECS precisam desse driver para funcionar corretamente e podem falhar ao iniciar sem ele.	Para instalar o driver virtio em uma imagem, consulte Instalar o driver virtio.
GUESTOS.BCD	Verifica se o arquivo Boot Configuration Data (BCD) na imagem é válido. Um arquivo BCD ausente ou corrompido pode causar falhas na inicialização da instância.	Use o arquivo BCD correto.
GUESTOS.Registry	Verifica se os arquivos de registro na imagem são válidos. Arquivos de registro ausentes ou corrompidos podem causar falhas na inicialização da instância.	Use os arquivos de registro corretos.
GUESTOS.Hotfix	Verifica a instalação correta de patches. A ausência de patches obrigatórios ou a instalação de patches conhecidos por causar problemas podem levar a falhas na inicialização da instância.	Desinstale patches incorretos. Patches incorretos incluem KB5009624, KB5009595, KB5009546, KB5009557, KB5009555, KB5014738, KB5014702, KB5014692 e KB5014678. Para sistemas operacionais Microsoft Windows Server 2008 R2 de 64 bits, também é necessário instalar o patch KB3033929.
GUESTOS.Disk	Verifica se as configurações de disco estão corretas. Entradas residuais de drivers no registro podem causar falhas na inicialização da instância.	Limpar drivers residuais do registro
GUESTOS.Sysprep	Verifica se o Sysprep foi concluído com sucesso durante a criação da imagem. Um processo Sysprep interrompido, por exemplo devido a um desligamento forçado, pode fazer com que a instância resultante falhe ao iniciar.	Crie a imagem novamente. Certifique-se de que o processo Sysprep não seja interrompido. Para mais informações, consulte Criar uma máquina virtual e instalar um sistema operacional.
GUESTOS.Update	Verifica se o processo de Atualização foi concluído durante a criação da imagem. Caso o processo tenha sido interrompido, por exemplo por um desligamento forçado, a instância poderá falhar ao iniciar.	Crie a imagem novamente. Garanta que o processo de atualização do sistema não seja interrompido. Para mais informações, consulte Criar uma máquina virtual e instalar um sistema operacional.
GUESTOS.Xen	Verifica a existência de drivers Xen residuais, que podem causar falhas na inicialização do sistema.	Desativar o driver Xen
GUESTOS.CloudAssistant	Verifica se o Cloud Assistant está instalado. O Cloud Assistant é uma ferramenta nativa de automação e gerenciamento para ECS que permite executar operações em lote, rodar comandos (como Shell, powershell e Bat) e transferir arquivos em instâncias ECS sem senhas, logins ou bastion hosts. Recomenda-se a instalação do Cloud Assistant para um gerenciamento eficiente das instâncias.	Para instalar o Cloud Assistant, consulte Instalar o Agente do Cloud Assistant.
GUESTOS.Server	Verifica se as configurações de serviço na imagem estão corretas. Se a instalação de drivers estiver desativada, a instância não conseguirá atualizar seus drivers.	Permitir instalação de drivers
GUESTOS.DesktopConfig	Verifica se o arquivo de configuração da área de trabalho (desktop.ini) está ausente. Se estiver faltando, as configurações da área de trabalho não serão aplicadas.	Configure o arquivo desktop.ini correto.
GUESTOS.BootMgr	Verifica se o gerenciador de inicialização do sistema (BootMgr) está ausente. A falta do BootMgr impede a inicialização do sistema.	Configure o BootMgr correto.

Limpar drivers residuais

A árvore de registro HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control contém informações de configuração que controlam a inicialização do sistema e determinados dispositivos. Sua subchave Class contém drivers de filtro registrados no dispositivo. Entradas residuais de drivers de softwares desinstalados podem fazer com que instâncias criadas a partir da imagem falhem ao iniciar. Esta seção explica como limpar manualmente essas entradas residuais.

Faça login no servidor de origem a partir do qual o arquivo de imagem foi criado.
Abra o Editor do Registro.

Por exemplo, no Windows 10, digite regedit na caixa de pesquisa da barra de tarefas e pressione Enter.
Abra a chave de registro do disco.

O caminho é HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\Class\{4d36e967-e325-11ce-bfc1-08002be10318}.
Confirme e exclua as entradas residuais de drivers.
1. Verifique o valor da propriedade UpperFilter para identificar entradas residuais de drivers.
  
  Uma entrada é considerada residual se seu arquivo de driver correspondente estiver ausente em C:\Windows\System32\drivers, mas sua entrada ainda constar em UpperFilters.
  
  Aviso
  Tenha cuidado ao excluir entradas de drivers. Certifique-se de que o driver não seja um driver padrão do sistema para evitar exceções no sistema.
  
  Por exemplo, partmgr é um driver padrão do sistema e não deve ser removido de UpperFilters. No caminho de registro HKEY_LOCAL_MACHINE\OfflineSYSTEM\ControlSet001\Control\Class\{4d36e967-e325-11ce-bfc1-08002be10318}, o valor de UpperFilters é partmgr. Trata-se de um driver padrão do sistema e não precisa ser excluído.
2. Em UpperFilters, exclua os nomes dos drivers residuais.

Desativar o driver Xen

Instâncias ECS não utilizam o driver Xen. No entanto, imagens mais antigas podem conter entradas residuais do driver Xen que causam falhas na inicialização. É possível desativar o driver Xen no registro.

Faça login no servidor de origem a partir do qual o arquivo de imagem foi criado.
Abra o Editor do Registro.

Por exemplo, no Windows 10, digite regedit na caixa de pesquisa da barra de tarefas e pressione Enter.
Abra a chave de registro correspondente.

O caminho é HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\XenPCI\Parameters.
Limpe o valor da propriedade hide_devices.

Clique duas vezes na propriedade hide_devices. Na caixa de diálogo exibida, limpe os dados do valor e clique em OK.

Permitir instalação de drivers

A árvore de registro HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services registra todos os serviços no sistema. Alguns serviços controlam se os drivers podem ser instalados. Se a instalação de drivers estiver desativada no registro da imagem, as instâncias criadas a partir dela não poderão atualizar seus drivers. É necessário modificar a propriedade que desativa essa configuração.

Faça login no servidor de origem a partir do qual o arquivo de imagem foi criado.
Abra o Editor do Registro.

Por exemplo, no Windows 10, digite regedit na caixa de pesquisa da barra de tarefas e pressione Enter.
Abra a chave de registro correspondente.
- Para Windows Server 2008 R2 e posterior: HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\DeviceInstall\Parameters.
- Para Windows Server 2008 R2 e anterior: HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\PlugPlay\Parameters.
Modifique a propriedade que desativa a instalação de drivers. Se a propriedade DeviceInstallDisabled existir e seu valor não for 0, altere-o para 0 ou exclua a propriedade.
- Por exemplo, no Windows Server 2008 R2, essa propriedade é do tipo REG_DWORD e está localizada no caminho de registro HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\PlugPlay\Parameters.
- Por exemplo, no Windows Server 2016, se a propriedade DeviceInstallDisabled do tipo REG_DWORD no caminho de registro HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\DeviceInstall\Parameters tiver o valor 1, altere o valor para 0 ou exclua a propriedade.

Próximos passos

Após verificar e reparar uma imagem personalizada, use-a para criar uma instância ECS. Para mais informações, consulte Criar uma instância a partir de uma imagem personalizada ou compartilhada.