Criar uma nova versão de uma fórmula de imagem

Para criar uma nova versão de fórmula de imagem:

1. Na parte superior da página de detalhes da fórmula, escolha Criar nova versão. Isso leva você à página Criar fórmula de imagem.

2. Para criar a nova versão, faça suas alterações e depois escolha Criar fórmula.

   Sua imagem final pode conter até quatro códigos de produto de produtos e componentes de AWS Marketplace imagem. Se a imagem base e os componentes selecionados contiverem mais de quatro códigos de produto, o Image Builder retornará um erro quando você tentar criar a receita.

1. Criar um arquivo JSON de entrada da CLI

   Você pode fornecer toda a entrada para o comando create-image-recipe com parâmetros de comando embutidos. No entanto, o comando resultante pode ser bastante longo. Para simplificar o comando, você pode fornecer um arquivo JSON que contenha todas as configurações da fórmula.

   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 o CreateImageRecipecomando 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 AWS CLI Referência de comando.

   Aqui está um resumo dos parâmetros que esses exemplos especificam:

   • name (string, obrigatório): o nome da fórmula de imagem.

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

   • parentImage (string, obrigatório): a imagem que a fórmula de imagem usa como base para sua imagem personalizada. O valor pode ser o ARN de imagem de base ou um ID de AMI.

     nota

     Os exemplos do Linux e do macOS usam uma AMI do Image Builder, e o exemplo do Windows usa um ARN.

   • semanticVersion (string, obrigatório): a versão semântica da fórmula de imagem, expressa no seguinte formato, com valores numéricos em cada posição para indicar uma versão específica: <major>.<minor>.<patch>. Por exemplo, um valor pode ser 1.0.0. Para saber mais sobre o versionamento semântico dos recursos do Image Builder, consulte ‭Versionamento semântico no Image Builder‬.

   • components (matriz, obrigatório): contém uma variedade de objetos ComponentConfiguration. Pelo menos um componente da compilação deve ser especificado:

     nota

     O Image Builder instala os componentes na ordem em que você os especificou na fórmula. No entanto, os componentes de fortalecimento do CIS sempre são executados por último para garantir que os testes de benchmark sejam executados em relação à sua imagem de saída.

     • componentARN (string, obrigatório): o ARN do componente.

       dica

       Para usar um dos exemplos para criar sua própria receita de imagem, você deve substituir o exemplo ARNs ARNs pelo dos componentes que você está usando para sua receita.

     • parameters (matriz de objetos): contém uma variedade de objetos ComponentParameter. Se um parâmetro de entrada for necessário, mas não tiver um valor padrão definido no componente, você deverá fornecer um valor. O Image Builder não criará a versão da fórmula se algum parâmetro obrigatório estiver faltando e não houver um valor padrão definido.

       Importante

       Os parâmetros do componente são valores de texto simples e estão logados em AWS CloudTrail. Recomendamos que você use AWS Secrets Manager ou o AWS Systems Manager Parameter Store para armazenar seus segredos. Para obter mais informações sobre o Secrets Manager, consulte ‭O que é o Secrets Manager?‭‬ no AWS Secrets Manager Guia do usuário‭. Para obter mais informações sobre o ‭ AWS Systems Manager Parameter Store, consulte AWS Systems Manager ‬ Parameter Store‭‬ no AWS Systems Manager ‬ Guia do usuário‭.

       • nome (string, obrigatório): o nome do parâmetro do componente a ser definido.

       • value (matriz de strings, obrigatório): contém uma matriz de strings para definir o valor do parâmetro do componente nomeado. Se houver um valor padrão definido para o componente e nenhum outro valor for fornecido, AWSTOE use o valor padrão.

   • additionalInstanceConfiguration(objeto) — Especifique configurações adicionais e scripts de lançamento para suas instâncias de compilação.

     • systemsManagerAgent(object) — Contém configurações para o agente Systems Manager em sua instância de compilação.

       • uninstallAfterBuild(Boolean) — Controla se o agente do Systems Manager é removido da imagem de compilação final antes de criar a nova AMI. Se essa opção for definida para true, o atendente será removido da imagem final. Se a opção for definida para false, o atendente será mantido para que seja incluído na nova AMI. O valor padrão é false.

         nota

         Se o atributo uninstallAfterBuild não estiver incluído no arquivo JSON e as condições a seguir forem verdadeiras, o Image Builder removerá o atendente do Systems Manager da imagem final para que ele não fique disponível na AMI:

         • O userDataOverride está vazio ou foi omitido do arquivo JSON.

         • O Image Builder instalou automaticamente o atendente do Systems Manager na instância de compilação de um sistema operacional que não tinha o atendente pré-instalado na imagem de base.

     • userDataOverride(string) — Forneça comandos ou um script de comando para executar ao iniciar sua instância de compilação.

       nota

       Os dados do usuário são sempre codificados em base 64. Por exemplo, os seguintes comandos são codificados como IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg==:

       #!/bin/bash
       mkdir -p /var/bb/
       touch /var

       O exemplo do Linux usa esse valor codificado.

   Linux

   A imagem base (propriedade de parentImage) no exemplo a seguir é uma AMI. Ao usar uma AMI, você deve ter acesso à AMI, e a AMI deve estar na região de origem (a mesma região em que o Image Builder executa o comando). Salve o arquivo como create-image-recipe.json e use-o no comando create-image-recipe.

   {
   "name": "BB Ubuntu Image recipe",
   "description": "Hello World image recipe for Linux.",
   "parentImage": "ami-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   O exemplo a seguir se refere à versão mais recente da imagem de base completa em inglês do Windows Server 2016. O ARN neste exemplo faz referência à imagem mais recente no SKU com base nos filtros de versão semântica que você especificou: arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x.

   {
   "name": "MyBasicRecipe",
   "description": "This example image recipe creates a Windows 2016 image.",
   "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   nota

   Para saber mais sobre o versionamento semântico dos recursos do Image Builder, consulte ‭Versionamento semântico no Image Builder‬.

   macOS

   A imagem base (propriedade de parentImage) no exemplo a seguir é uma AMI. Ao usar uma AMI, você deve ter acesso à AMI, e a AMI deve estar na região de origem (a mesma região em que o Image Builder executa o comando). Salve o arquivo como create-image-recipe.json e use-o no comando create-image-recipe.

   {
   "name": "macOS Catalina Image recipe",
   "description": "Hello World image recipe for macOS.",
   "parentImage": "ami-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

2. Criar a fórmula

   Use o comando a seguir para criar a fórmula. Forneça o nome do arquivo JSON que você criou na etapa anterior no parâmetro --cli-input-json:

   aws imagebuilder create-image-recipe --cli-input-json file://create-image-recipe.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, enquanto o Linux e o macOS usam a barra (/).

   Sua imagem final pode conter até quatro códigos de produto de produtos e componentes de AWS Marketplace imagem. Se a imagem base e os componentes selecionados contiverem mais de quatro códigos de produto, o Image Builder retornará um erro ao executar o create-image-recipe comando.

1. Na seção Selecionar imagem para a imagem de base, selecione a opção Importar imagem de base.

2. Escolha o Sistema operacional (OS) de imagem e a Versão do OS como você faria normalmente.

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.

Geral

1. Especifique um Nome exclusivo para a imagem de base. Se você não inserir um valor, a imagem de base herdará o nome da fórmula.

2. Especifique uma Versão para a imagem de base. Use o formato a seguir: <major>.<minor>.<patch>. Se você não inserir um valor, a imagem de base herdará a versão da fórmula.

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