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

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

1. Na página de detalhes da receita do contêiner, escolha Criar nova versão na parte superior da página. O console abre a página Criar receita para receitas de contêineres.

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 CreateContainerRecipe comando na Referência da API 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 neste exemplo:

   • componentes (matriz de objetos, opcional) — Contém uma matriz de ComponentConfiguration objetos. Os componentes são opcionais para receitas de contêineres. Você pode personalizar a imagem de saída com componentes BUILD, com instruções em seu modelo Dockerfile (por exemplo, RUN ou COPY declarações), ou ambos. Os componentes TEST validam a imagem, mas não a modificam.

     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 fórmula de contêiner, substitua os ARNs de exemplo pelos ARNs dos componentes que você está usando para sua fórmula. 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 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 usará o valor padrão.

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

   • dockerfile TemplateData (string) — O modelo embutido do Dockerfile para criar sua imagem. Os dados embutidos são limitados a 16.000 caracteres. Você precisa especificar o dockerfileTemplateData ou o dockerfileTemplateUri, mas não os dois.

     Seu modelo do Dockerfile pode incluir variáveis contextuais (espaços reservados que o Image Builder substitui por informações de compilação em tempo de execução). Inclua pelo menos a parentImage variável. Se sua receita incluir componentes, inclua também a environments variável e a components variável.

     parentImage (obrigatória)

     No momento da compilação, esta variável é resolvida na imagem de base da sua fórmula.

     Exemplo:

     FROM
     {{{ imagebuilder:parentImage }}}

     environments (necessários se os componentes forem especificados)

     No momento da construção, essa variável é resolvida para as diretivas do Dockerfile que colocam seus componentes no contexto de construção. Essas diretivas copiam os scripts do componente na imagem e definem as variáveis de ambiente que esses scripts usam. Ele prepara o ambiente, mas não executa os componentes que você especifica. Coloque essa variável antes da components variável.

     Exemplo:

     {{{ imagebuilder:environments }}}

     components (opcional)

     No momento da compilação, essa variável é resolvida para o comando que executa os scripts dos componentes de construção e teste dos componentes que a receita do contêiner inclui e, em seguida, remove esses scripts da imagem. Essa é a variável que executa seus componentes. Coloque-o depois da environments variável.

     Exemplo:

     {{{ imagebuilder:components }}}

     Em vez disso, para armazenar o modelo no Amazon S3, use o TemplateUri parâmetro dockerfile com um URI válido do Amazon S3 (por exemplo,). s3://my-bucket/templates/Dockerfile

   • 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, required) — A imagem do Docker contêiner a ser usada na receita do contêiner como linha de base para sua imagem personalizada.

     • Imagens públicas hospedadas em DockerHub

     • Imagens de contêiner existentes no Amazon ECR

     • Amazon-managed imagens de contêiner

   • platformOverride (string) - Especifica a plataforma do sistema operacional quando você usa uma imagem base personalizada. Recomendamos que você defina esse valor ao usar uma Docker Hub imagem do Amazon ECR. Se você omiti-lo, o Image Builder tentará detectar a plataforma a partir do manifesto do contêiner, que talvez nem sempre esteja disponível. Você não pode especificar platformOverride quando sua imagem principal é um ARN de imagem do Image Builder. Os valores válidos são Linux e Windows. As receitas de contêiner não são compatíveis com a plataforma macOS.

   • 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) — A imagem base para uma instância de construção e teste de contêiner. Isso pode conter um ID de AMI ou especificar um parâmetro de armazenamento de parâmetros AWS Systems Manager (SSM), prefixado porssm:, seguido pelo nome do parâmetro ou ARN. Se você usar um parâmetro SSM, o valor do parâmetro deverá conter um ID de AMI. Se você não especificar uma imagem base, o Image Builder usa a AMI otimizada apropriada do Amazon ECS como imagem base.

     • bloco DeviceMappings (matriz de objetos) — Define os dispositivos de bloco a serem anexados 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.

         • delete OnTermination (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.

     • service (string, required) — Especifica o serviço de repositório que armazena a imagem de saída. O valor válido é ECR. O repositório de destino já deve existir.

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

   O exemplo a seguir mostra um arquivo de entrada de receita de contêiner completo que define um Docker contêiner Linux com componentes de compilação. Salve-o como create-container-recipe.json e use-o no create-container-recipe comando.

   {
   	"components": [ 
   	  { 
   		 "componentArn": "arn:aws:imagebuilder:us-west-2:111122223333: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-1234567890abcdef1",
   	  "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 (/).

   O exemplo de saída a seguir mostra o ARN da receita de contêiner recém-criada, junto com o ID da solicitação e o token do cliente para a solicitação.

   {
   	"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
   	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
   	"containerRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.2"
   }