Elastic Compute Service:Create an image template and run an image building task

Pré-requisitos

Ao criar componentes ou modelos de imagem pela primeira vez, o sistema cria a função vinculada ao service AliyunServiceRoleForECSImageBuilder, que concede ao Image Builder acesso aos recursos necessários da Alibaba Cloud. Se utilizar um usuário RAM, conceda-lhe as permissões para usar o Image Builder. Contas Alibaba Cloud recebem essas permissões automaticamente. Consulte Manage service-linked role.

Etapa 1: Criar um modelo de imagem

1. Acesse ECS Console - Image Builder.

2. No canto superior esquerdo da página, selecione uma região e um grupo de recursos.

3. Na aba Image Builder da página Image Templates, clique em Create Image Template.

   Nota

   Ao acessar o Image Builder pela primeira vez, clique em Image Builder na página de boas-vindas Create Image Template.

4. Na página exibida, configure os parâmetros e clique em OK.

   As tabelas a seguir descrevem os parâmetros.

   • Basic Information

     Parâmetro	Obrigatório	Descrição
     Template Name	Sim	Especifique um nome para o modelo de imagem.
     Description	Não	Insira uma descrição para o modelo de imagem.
     Tag	Não	Adicione tags ao modelo de imagem. Consulte Tags.

   • Configure Source Image

     Parâmetro	Obrigatório	Descrição
     Source Image Type	Sim	Selecione Image ou Image Family. Nota O sistema aceita apenas imagens públicas, personalizadas, compartilhadas e famílias de imagens como origem. Imagens do Marketplace e da comunidade não são compatíveis.
     Image ou Image Family	Sim	Especifique a imagem de origem. As opções variam conforme o valor de Source Image Type. Se Source Image Type estiver definido como Image, selecione Custom Images, Public Images ou Shared Images na primeira lista suspensa e escolha um ID de imagem na segunda lista. Se Source Image Type estiver definido como Image Family, selecione uma família de imagens existente.

   • Configure Template Content

     Parâmetro	Obrigatório	Descrição
     Template Content	Não	Adicione componentes de imagem ao modelo de criação para compor o modelo de imagem. Nota Componentes de imagem do sistema geram imagens estáveis e confiáveis. Recomendamos utilizá-los para criar modelos de imagem. Os componentes de imagem estão disponíveis apenas no console ecs. Operações de API não aceitam componentes de imagem para criação de modelos.
     Perform Image Repair	Não	Ative o reparo de imagem para verificar e corrigir automaticamente problemas comuns antes da execução da tarefa de criação. Ativado por padrão. Para consultar os itens de reparo compatíveis, veja o parâmetro RepairItem em CreateImagePipeline. Nota Se desativado, o sistema verifica a imagem, mas não executa reparos.
     Perform Image Test	Não	Ative o teste de imagem. Após a conclusão da criação, o sistema testa automaticamente a nova imagem com os componentes especificados para confirmar seu funcionamento adequado. Importante Durante os testes, o sistema cria e fatura instâncias intermediárias de pagamento conforme o uso. Consulte Pay-as-you-go. Ativado por padrão.
     Verify Template	Sim	Selecione componentes de imagem do tipo Teste para o modelo de teste de imagem.

   • Configure Intermediate Instance

     Importante

     A criação de imagem gera múltiplas instâncias intermediárias de pagamento conforme o uso. Consulte Pay-as-you-go.

     Parâmetro	Obrigatório	Descrição
     vSwitch	Não	Selecione um vSwitch na região atual. Se nenhum for especificado, o sistema cria uma VPC e um vSwitch temporários. Verifique se a região possui cotas de recursos suficientes.
     Instance Type	Não	Escolha um tipo de instância para as instâncias intermediárias. Sem especificação, o sistema seleciona automaticamente o tipo com menos vCPUs e memória, conforme a disponibilidade. Por exemplo, ecs.g6.large tem prioridade; se indisponível, ecs.g6.xlarge será utilizado.
     System Disk Size	Não	Tamanho do disco do sistema para cada instância intermediária. Unidade: GiB. Valores válidos: 20 a 500. Valor padrão: 40.
     Public Bandwidth (Mbps)	Não	Se o conteúdo do modelo incluir comandos que exigem acesso à Internet, defina a largura de banda pública com um valor diferente de zero. Caso contrário, a tarefa de criação falhará. Valor padrão: 0 (sem acesso à Internet para instâncias intermediárias).
     Release if Image Building Fails	Não	Define se as instâncias intermediárias devem ser liberadas após falha na tarefa de criação. Nota Se você selecionar No para reter as instâncias intermediárias, a cobrança continuará mesmo após a falha da tarefa. Libere prontamente as instâncias desnecessárias. Consulte Release an instance. Valor padrão: Yes.

   • Configure Image Distribution

     Parâmetro	Obrigatório	Descrição
     Destination Image Name	Não	Prefixo de nome para a imagem criada. O sistema acrescenta o ID da tarefa de criação de imagem (ExecutionId) para formar o nome completo no formato <Custom name prefix>_<ID of the image building task>. Valor padrão: the ID of the image building task.
     Current Region	Não	Defina regiões de distribuição para copiar a imagem para múltiplas regiões. É possível especificar até 20 regiões. Valor padrão: a região onde o modelo de imagem está localizado.
     Sharee UID	Não	Indique os UIDs de contas Alibaba Cloud com quem compartilhar a imagem criada. O compartilhamento ocorre na mesma região. Limite de 20 UIDs. Vazio por padrão.
     Execute Immediately	Não	Determina se a tarefa de criação de imagem deve ser executada imediatamente. Se não estiver ativado, inicie a tarefa manualmente após a criação do modelo. Consulte a seção Step 2: Execute an image building task. Ativado por padrão.

5. (Opcional) Visualize os detalhes do modelo de imagem.

   Clique no ID do modelo de imagem para ver seus detalhes.

   • Na aba Building History, consulte o histórico de execuções.

   • Na aba Build Template, visualize o conteúdo do modelo de criação.

   • Na aba Test Template, examine o conteúdo do modelo de teste.

Etapa 2: Executar uma tarefa de criação de imagem

Se você não ativou a opção Execute Immediately durante a criação do modelo, inicie manualmente a tarefa de criação de imagem conforme descrito abaixo.

Procedimento

1. Acesse ECS Console - Image Builder.

2. No canto superior esquerdo da página, selecione uma região e um grupo de recursos.

3. Na aba Test Template da página Image Builder, localize o modelo de imagem desejado e clique em Execute na coluna Actions.

   Nota

   • Para cancelar uma tarefa em andamento, clique no ID do modelo de imagem, encontre a tarefa na aba Building History e clique em Cancel na coluna Actions.

   • O tempo de criação da imagem varia conforme os services implantados e os comandos de criação utilizados.

   • Após a conclusão da tarefa, o status Successful aparece na coluna Status e o ID da imagem é exibido. Clique no ID da imagem para visualizar os detalhes.

   • Caso a tarefa apresente o estado Failed, verifique a coluna Execution Result para obter detalhes do erro e solucionar o problema.

Referências

• Operações de API relacionadas:

  • CreateImagePipeline: cria um modelo de imagem.

  • StartImagePipelineExecution: executa uma tarefa de criação de imagem.

  • DescribeImagePipelines: consulta modelos de imagem.

  • DescribeImagePipelineExecutions: consulta detalhes de tarefas de criação de imagem.

  • CancelImagePipelineExecution: cancela uma tarefa de criação de imagem.

• Após criar uma imagem com um modelo, você pode:

  • Visualizar a imagem personalizada em cada região de distribuição.

  • Utilizar a imagem para create ecs instances ou replace the OS (system disk) de instâncias existentes.