Criar uma nova versão de fórmula de contêiner

Para criar uma nova fórmula de contêiner:

1. Na parte superior da página de detalhes da fórmula do contêiner, escolha Criar nova versão. Você será direcionado para a página Criar fórmula para fórmulas de contêiner.

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

1. Criar um arquivo JSON de entrada da CLI

   Você pode fornecer toda a entrada para o comando create-container-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 do contêiner

   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 CreateContainerRecipecomando 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 neste exemplo:

   • componentes (matriz de objetos, obrigatório): contém uma matriz de ComponentConfiguration objetos. 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 o exemplo para criar sua própria receita de contêiner, substitua o ARNs exemplo ARNs pelo dos componentes que você está usando para sua receita,. Isso inclui o Região da AWS, nome, e o número da versão de cada um.

     • 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.

   • ContainerType (string, obrigatório): o tipo de contêiner a ser criado. Os valores válidos são: DOCKER.

   • dockerfileTemplateData(string) — O modelo Dockerfile usado para criar sua imagem, expresso como um blob de dados embutido.

   • name (string, obrigatório): o nome da fórmula do contêiner.

   • description (string): a descrição da fórmula do contêiner.

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

   • platformOverride (string) - Especifica a plataforma do sistema operacional quando você usa uma imagem base personalizada.

   • SemanticVersion (string, obrigatório): a versão semântica da fórmula do contêiner especificada no formato a seguir, com valores numéricos em cada posição para indicar uma versão específica: <major>,<minor>,<patch> . Um exemplo seria 1.0.0. Para saber mais sobre o versionamento semântico dos recursos do Image Builder, consulte Versionamento semântico no Image Builder.

   • tags (string map) - Tags que estão anexadas à fórmula do contêiner.

   • instanceConfiguration (objeto) - Um grupo de opções que pode ser utilizado para configurar uma instância para compilar e testar imagens de contêiner.

     • image (string) - O ID da AMI a ser usado como imagem base para uma instância de compilação e teste de contêineres. Se você não especificar esse valor, o Image Builder usará a AMI otimizada do Amazon ECS apropriada como imagem base.

     • blockDeviceMappings(matriz de objetos) — Define os dispositivos de bloco a serem conectados para criar uma instância a partir da AMI do Image Builder especificada no image parâmetro.

       • deviceName (string): o dispositivo ao qual esses mapeamentos se aplicam.

       • ebs (objeto) - Use para gerenciar a configuração específica do Amazon EBS para esse mapeamento.

         • deleteOnTermination(Boolean) — Usado para configurar a exclusão no encerramento do dispositivo associado.

         • encrypted (booleano): usado para configurar a criptografia do dispositivo.

         • volumeSize (inteiro): usado para substituir o tamanho do volume do dispositivo.

         • volumeSize (string): usado para substituir o tipo do volume do dispositivo.

   • targetRepository (objeto, obrigatório): o repositório de destino da imagem do contêiner, se não houver outro repositório especificado na configuração de distribuição do pipeline para a região onde o pipeline é executado (Região 1).

     • repositoryName (string, obrigatório) - O nome do repositório de contêiner onde a imagem do contêiner de saída é armazenada. Este nome é prefixado pelo local do repositório.

     • serviço (string, obrigatório) - Especifica o serviço no qual esta imagem foi registrada.

   • workingDirectory (string) - O diretório de trabalho a ser usado durante os fluxos de trabalho de compilação e teste.

   {
   	"components": [ 
   	  { 
   		 "componentArn": "arn:aws:imagebuilder:us-east-1:123456789012:component/helloworldal2/x.x.x"
   	  }
   	],
   	"containerType": "DOCKER",
   	"description": "My Linux Docker container image",
   	"dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
   	"name": "amazonlinux-container-recipe",
   	"parentImage": "amazonlinux:latest",
   	"platformOverride": "Linux",
   	"semanticVersion": "1.0.2",
   	"tags": { 
   	  "sometag" : "Tag detail" 
   	},
   	"instanceConfiguration": {
   	  "image": "ami-1234567890",
   	  "blockDeviceMappings": [
   		 {
   			"deviceName": "/dev/xvda",
   			"ebs": {
   				"deleteOnTermination": true,
   				"encrypted": false,
   				"volumeSize": 8,
   				"volumeType": "gp2"
   			 }
   		  }			
   	  ]
   	},
   	"targetRepository": { 
   	  "repositoryName": "myrepo",
   	  "service": "ECR"
   	},
   	"workingDirectory": "/tmp"
   }

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-container-recipe --cli-input-json file://create-container-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 (/).