As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Importar e exportar imagens de máquina virtual com o Image Builder Quando você exporta uma VM de seu ambiente de virtualização, esse processo cria um conjunto de um ou mais arquivos de contêiner de disco que atuam como instantâneos do ambiente, das configurações e dos dados da sua VM. Você pode usar esses arquivos para importar sua VM e usá-la como imagem base para suas fórmulas de imagens. Para exportar, você pode criar arquivos de disco VM como saída da sua criação de imagem personalizada e distribuir os arquivos. O Image Builder é compatível com os seguintes formatos de arquivo para seus contêineres de disco de VM: + Arquivo de virtualização aberto (OVA) + Disco de máquina virtual (VMDK) + Disco rígido virtual (VHD/VHDX) + Bruto A importação usa os discos para criar uma imagem de máquina da Amazon (AMI) e um recurso de imagem Image Builder, ambos os quais podem servir como imagem base para sua fórmula de imagem personalizada. Os discos da VM devem ser armazenados em buckets do S3 para a importação. Você também pode importar de um snapshot de EBS existente. No console do Image Builder, você pode importar a imagem diretamente e, em seguida, usar a imagem de saída ou a AMI em suas fórmulas, ou você pode especificar parâmetros de importação ao criar sua fórmula ou versão da fórmula. Para obter mais informações sobre a importação como parte de sua fórmula de imagem, consulte [Configuração de importação de VM](create-image-recipes.md#import-vm-recipe-console-config). ## Importar uma VM para o Image Builder O Image Builder se integra à Import/Export API da Amazon EC2 VM para permitir que o processo de importação seja executado de forma assíncrona em segundo plano. O Image Builder faz referência ao ID da tarefa de importação da VM para monitorar seu progresso e cria um recurso de imagem do Image Builder como saída. Isso permite que você faça referência ao recurso de imagem do Image Builder em suas fórmulas antes que a importação da VM termine. ------ #### [ Console ] Para importar uma VM com o console do Image Builder, siga estas etapas: 1. Abra o console do EC2 Image Builder em [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. Escolha **Imagens** no painel de navegação. 1. Para abrir a caixa de diálogo de importação, escolha **Importar imagem**. 1. Insira as seguintes informações **gerais**: + Especifique um **nome** exclusivo para sua imagem. + Especifique uma **Versão** para a imagem de base. Use o formato a seguir: `major.minor.patch`. 1. Escolha o tipo de importação: **importação de VM**. 1. Forneça detalhes para cada uma das seções a seguir na página **Importar imagem**. Em seguida, selecione **Import image** ao concluir. **Sistema operacional da imagem de base** 1. Selecione a opção **Image Operating System (OS)** que corresponda à sua plataforma VM OS. 1. 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 importação VMs no Image Builder, consulte[Importar e exportar imagens de VM](#vm-import-export). 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. 1. **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**. 1. Para adicionar um contêiner de disco, escolha **Adicionar contêiner de disco**.   1. **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.   1. **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 **Adicionar tag**. Para remover uma tag, selecione **Remover tag**. ------ #### [ AWS CLI ] Para importar uma VM de discos para uma AMI e criar um recurso de imagem do Image Builder que você possa referir imediatamente, siga estas etapas na AWS CLI: 1. Inicie uma importação de VM, com o Import/Export **import-image** comando Amazon EC2 VM 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 [Importando uma VM como imagem usando o VM Import/Export no Guia do usuário da VM](https://docs.aws.amazon.com/vm-import/latest/userguide/vmimport-image-import.html). Import/Export *   1. **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 operação da API Image Builder. Para revisar os parâmetros da solicitação de operação da API, consulte a [ImportVmImage](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ImportVmImage.html)operação na *Referência da API 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: ... Por exemplo, .`1.0.0` Para saber mais sobre o versionamento semântico dos recursos do Image Builder, consulte ‭[Versionamento semântico no Image Builder](ibhow-semantic-versioning.md)‬. + **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 Amazon EC2 VM. 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. + **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", "tags": { "Usage": "VMIE" } } ``` 1. **Importar a imagem** Execute o comando **[import-vm-image](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/import-vm-image.html)** 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 (\$1) para se referir ao caminho do diretório, enquanto o Linux e o macOS usam a barra (/). ------ ## Distribua discos VM de sua imagem, crie a partir do AWS CLI Você pode configurar a distribuição de arquivos de formato de disco VM compatíveis para buckets do S3 nas regiões de destino como parte do seu processo normal de criação de imagens, usando as configurações de distribuição do Image Builder no. AWS CLI Para obter mais informações, consulte [Exemplo: Crie configurações de distribuição para discos VM de saída do AWS CLI](cr-upd-ami-distribution-settings.md#cli-create-vm-dist-config).