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á.
Importe e exporte imagens de máquinas virtuais com o Image Builder
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 que atuam como snapshots 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.
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)
-
Raw
A importação usa os discos para criar uma Amazon Machine Image (AMI) e um recurso de imagem Image Builder, cada um dos quais pode servir como imagem base para sua receita de imagem personalizada. Os discos da VM devem ser armazenados em buckets do S3 para a importação. Como alternativa, você pode importar de um EBS snapshot existente.
No console do Image Builder, você pode importar a imagem diretamente e, em seguida, usar a imagem de saída ou AMI em suas receitas, ou você pode especificar parâmetros de importação ao criar sua receita ou versão da receita. Para obter mais informações sobre a importação como parte de sua fórmula de imagem, consulteConfiguração de importação de VM.
Importar uma VM para o Image Builder
O Image Builder se integra ao Amazon EC2 VM Import/Export API 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:
-
Abra o console do EC2 Image Builder em https://console.aws.amazon.com/imagebuilder/.
-
Escolha Imagens no painel de navegação.
-
Escolha Importar imagem.
-
Forneça detalhes para cada uma das seções a seguir na página Importar imagem. Em seguida, selecione Import image ao concluir.
Geral
-
Especifique um Nome exclusivo para a imagem de base.
-
Especifique uma Versão para a imagem de base. Use o formato a seguir: major.minor.patch
.
-
Você também pode inserir uma Descrição opcional para a imagem de base.
Sistema operacional da imagem de base
-
Selecione a opção Image Operating System (OS) que corresponda à sua plataforma VM OS.
-
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
-
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, consulteImportar 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.
-
Origem — pode ser um bucket do S3 ou um EBS snapshot.
-
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.
-
Para adicionar um contêiner de disco, escolha Adicionar contêiner de disco.
-
Função da IAM
Para associar uma IAM função à sua configuração de importação de VM, selecione a IAMfunção na lista suspensa da função ou escolha Criar nova função para criar uma nova. Se você criar uma nova função, a página do console IAM Funções será aberta em uma guia separada.
-
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 uma KMS chave para a importação, selecione um valor na lista Criptografia (KMSchave). A lista contém KMS chaves à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 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
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.
- AWS CLI
-
Para importar uma VM de discos para um AMI e criar um recurso de imagem do Image Builder que você possa referenciar imediatamente, siga estas etapas do: AWS CLI
-
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.
-
Criar um JSON arquivo CLI de entrada
Para simplificar o import-vm-image comando Image Builder usado no AWS CLI, criamos um JSON arquivo que contém toda a configuração de importação que queremos passar para o comando.
A convenção de nomenclatura para os valores de dados no JSON arquivo segue o padrão especificado para os parâmetros de solicitação de API ação do Image Builder. Para revisar os parâmetros da solicitação de API comando, consulte o ImportVmImagecomando na APIReferência 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<major>(string, obrigatório) — A versão semântica da imagem de saída que especifica a versão no seguinte formato, com valores numéricos em cada posição para indicar uma versão específica:. <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 Amazon EC2 VM. O Image Builder monitora o processo de importação para extrair o AMI que ele cria e criar um recurso de imagem do Image Builder que pode ser usado em receitas imediatamente.
-
clientToken(string, required) — Um identificador exclusivo que diferencia maiúsculas de minúsculas que você fornece para garantir a idempotência da solicitação. Para obter mais informações, consulte Garantir a idempotência na Amazon Reference. EC2 API
-
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"
}
}
-
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
-
Você deve incluir a file://
notação no início do caminho do JSON arquivo.
-
O caminho para o JSON arquivo deve seguir a convenção apropriada para o sistema operacional básico em que 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 (/).
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 ter mais informações, consulte Crie configurações de distribuição para discos VM de saída do AWS CLI.