Importe e exporte imagens de máquinas virtuais com o EC2 Image Builder

1. Abra o console do EC2 Image Builder em https://console.aws.amazon.com/imagebuilder/.

2. Escolha Imagens no painel de navegação.

3. Escolha Importar imagem.

4. Forneça detalhes para cada uma das seções a seguir na página Importar imagem. Em seguida, selecione Import image ao concluir.

Geral

1. Especifique um Nome exclusivo para a imagem de base.

2. Especifique uma Versão para a imagem de base. Use o formato a seguir: major.minor.patch.

3. Você também pode inserir uma Descrição opcional para a imagem de base.

Sistema operacional da imagem de base

1. Selecione a opção Image Operating System (OS) que corresponda à sua plataforma VM OS.

2. Selecione a OS version (versão do sistema operacional) que corresponde à versão da sua VM na lista.

Configuração de importação de VM

1. Quando você exporta sua VM do ambiente de virtualização, esse processo cria um conjunto de um ou mais arquivos de contêiner de disco. Eles atuam como instantâneos do ambiente, das configurações e dos dados da sua VM. Você pode usar esses arquivos para importar sua VM como imagem de base para sua fórmula de imagem. Para obter mais informações sobre como importar VMs no Image Builder, consulte Importar e exportar imagens de VM.

   Para especificar a localização da sua fonte de importação, siga estas etapas:

    

   Importar fonte

   Especifique a fonte do primeiro contêiner de disco ou snapshot de imagem da VM a ser importado na seção Contêiner de disco 1.

   1. Fonte: essa pode ser um bucket do S3 ou um snapshot do EBS.

   2. Selecione a localização do disco do S3: insira a localização no Amazon S3 onde suas imagens de disco estão armazenadas. Para procurar o local, escolha Browse S3.

   3. Para adicionar um contêiner de disco, escolha Adicionar contêiner de disco.

    

2. IAM role (Perfil do IAM)

   Para associar um Perfil do IAM à sua configuração de importação de VM, selecione o perfil na lista suspensa de Perfil do IAM ou escolha Criar novo perfil para criar um novo. Se você criar um novo perfil, a página do console de Perfis do IAM será aberta em uma guia separada.

    

3. Configurações avançadas: opcionais

   As seguintes configurações são opcionais. Com essas configurações, você pode configurar criptografia, licenciamento, tags e muito mais para a imagem de base criada pela importação.

   Arquitetura da imagem de base

   Para especificar a arquitetura da sua fonte de importação de VM, selecione um valor na lista Arquitetura.

   Criptografia

   Se as imagens de disco da VM estiverem criptografadas, você deverá fornecer uma chave para usar no processo de importação. Para especificar um para a importação, selecione um valor na lista Criptografia (chave KMS). A lista contém chaves KMS às quais sua conta tem acesso na região atual.

   Gerenciamento de licença

   Quando você importa uma VM, o processo de importação detecta automaticamente o OS da VM e aplica a licença apropriada à imagem de base. Dependendo da plataforma do seu OS, os tipos de licença são os seguintes:

   • Licença incluída: Uma licença AWS apropriada para sua plataforma é aplicada à sua imagem de base.

   • Traga a sua própria licença (BYOL): Retém a licença da sua VM, se aplicável.

   Para anexar as configurações de licença criadas com AWS License Manager à sua imagem base, selecione na lista Nome da configuração da licença. Para obter mais informações sobre o License Manager, consulte Trabalhando com AWS License Manager

   nota

   • As configurações de licença contêm regras de licenciamento com base nos termos de seus contratos empresariais.

   • O Linux só oferece suporte a licenças BYOL.

   Tags (imagem de base)

   As tags usam pares de chave–valor para atribuir texto pesquisável ao seu recurso do Image Builder. Para especificar tags para a imagem de base importada, insira pares de chave–valor com as caixas Chave e Valor.

   Para adicionar uma tag, escolha Add tag. Para remover uma tag, selecione Remover tag.

1. Inicie uma importação de VM, com o comando Amazon EC2 VM import-image Import/Export no AWS CLI. Anote a ID de tarefa que for retornada na resposta de comando. Você precisará dela para a próxima etapa. Para obter mais informações, consulte Como importar uma VM como uma imagem usando o VM Import/Export no Guia do usuário de VM Import/Export.

    

2. Criar um arquivo JSON de entrada da CLI

   Para simplificar o import-vm-image comando Image Builder usado no AWS CLI, criamos um arquivo JSON que contém toda a configuração de importação que queremos passar para o comando.

   nota

   A convenção de nomenclatura para os valores de dados no arquivo JSON segue o padrão especificado para os parâmetros de solicitação de ação da API Image Builder. Para revisar os parâmetros de solicitação de comando da API, consulte o ImportVmImagecomando na Referência da API do EC2 Image Builder.

   Para fornecer os valores dos dados como parâmetros da linha de comando, consulte os nomes dos parâmetros especificados na Referência de comando do AWS CLI para o comando do import-vm-image como opções.

   Aqui está um resumo dos parâmetros que especificamos nestes exemplos:

   • name (string, obrigatório): o nome do recurso de imagem do Image Builder a ser criado como saída da importação.

   • SemanticVersion (string, obrigatório): a versão semântica da imagem de saída que especifica a versão no formato a seguir, com valores numéricos em cada posição para indicar uma versão específica: <major>.<minor>.<patch>. Por exemplo, 1.0.0. Para saber mais sobre o versionamento semântico dos recursos do Image Builder, consulte ‭Controle de versão semântico no Image Builder‬.

   • description (string): a descrição da fórmula de imagem.

   • platform (string, obrigatório): a plataforma do sistema operacional para a VM importada.

   • vmImportTaskId (string, obrigatório) — O ImportTaskId (AWS CLI) do processo de importação da VM do Amazon EC2. O Image Builder monitora o processo de importação para extrair a AMI que ele cria e criar um recurso de imagem do Image Builder que pode ser usado em fórmulas imediatamente.

   • clientToken (string, obrigatório): um identificador exclusivo e que diferencia maiúsculas e minúsculas que você fornece para garantir a idempotência da solicitação. Para obter mais informações, consulte Garantir idempotência na Referência da API do Amazon EC2.

   • tags (string map): as tags são pares de chave-valor anexados aos recursos de importação. São permitidos até 50 pares chave-valor.

   Salve o arquivo como import-vm-image.json, para usar no comando import-vm-image do Image Builder.

   {
       "name": "example-request",
       "semanticVersion": "1.0.0",
       "description": "vm-import-test",
       "platform": "Linux",
       "vmImportTaskId": "import-ami-01ab234567890cd1e",
       "clientToken": "asz1231231234cs3z",
       "tags": {
       	"Usage": "VMIE"
       }
   }

3. Importar a imagem

   Execute o comando import-vm-image com o arquivo que você criou como entrada:

   aws imagebuilder import-vm-image --cli-input-json file://import-vm-image.json

   nota

   • É necessário incluir a notação file:// no início do caminho do arquivo JSON.

   • O caminho para o arquivo JSON deve seguir a convenção apropriada para o sistema operacional de base no qual você está executando o comando. Por exemplo, o Windows usa a barra invertida (\) para se referir ao caminho do diretório e o Linux usa a barra (/).