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 de imagem.

1. Criar um JSON arquivo CLI de entrada

   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 JSON arquivo que contenha todas as configurações da receita.

   nota

   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 CreateImageRecipecomando 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 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, required) — A imagem que a receita da imagem usa como base para sua imagem personalizada. O valor pode ser a imagem base ARN ou um AMI ID.

     nota

     O exemplo do Linux usa um Image BuilderAMI, e o exemplo do Windows usa umARN.

   • semanticVersion<major>(string, obrigatório) — A versão semântica da receita da imagem, expressa no seguinte formato, com valores numéricos em cada posição para indicar uma versão específica:. <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 ‭Controle de versão 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 CIS de endurecimento sempre são executados por último para garantir que os testes de benchmark sejam executados em relação à sua imagem de saída.

     • component ARN (string, obrigatório) — O componenteARN.

       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 receita se houver algum parâmetro obrigatório ausente e não tiver 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 novaAMI. Se essa opção for definida para true, o atendente será removido da imagem final. Se a opção for definida comofalse, o agente será deixado dentro para que seja incluído no novoAMI. O valor padrão é false.

         nota

         Se o uninstallAfterBuild atributo não estiver incluído no JSON arquivo e as seguintes condições forem verdadeiras, o Image Builder removerá o agente do Systems Manager da imagem final para que ele não esteja disponível noAMI:

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

         • 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 (parentImagepropriedade) no exemplo a seguir é umaAMI. Ao usar umAMI, você deve ter acesso aoAMI, e o 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. ARNNeste exemplo, faz referência à imagem mais recente do 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 ‭Controle de versão semântico no Image Builder‬.

2. Criar a fórmula

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

   aws imagebuilder create-image-recipe --cli-input-json file://create-image-recipe.json

   nota

   • 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 (/).

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. Origem — Isso pode ser um bucket do S3 ou um EBS snapshot.

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.