Crie um pipeline AMI de imagens a partir do AWS CLI

Você pode criar um pipeline de AMI imagem com um JSON arquivo que contém detalhes de configuração como entrada para o create-image-pipeline comando no AWS CLI.

A frequência com que seu pipeline cria uma nova imagem para incorporar quaisquer atualizações pendentes da imagem base e dos componentes depende do schedule que você configurou. Cada schedule tem os atributos a seguir:

• scheduleExpression: define o cronograma de execução do pipeline para avaliar pipelineExecutionStartCondition e determinar se ele deve iniciar uma compilação. A programação é configurada com expressões cron. Para obter mais informações sobre como formatar uma expressão cron no Image Builder, consulte Use expressões cron no Image Builder.

• pipelineExecutionStartCondition: determina se seu pipeline deve iniciar a compilação. Os valores válidos são:

  • EXPRESSION_MATCH_ONLY: seu pipeline compilará uma imagem sempre que a expressão cron corresponder à hora atual.

  • EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE: seu pipeline não iniciará uma nova compilação de imagem, a menos que haja alterações pendentes em sua imagem base ou em seus componentes.

Quando você executa o create-image-pipeline comando no AWS CLI, muitos dos recursos de configuração são opcionais. No entanto, alguns dos recursos têm requisitos condicionais, dependendo do tipo de imagem que o pipeline cria. Os seguintes recursos são necessários para pipelines de AMI imagens:

• Receita de imagem ARN

• Configuração da infraestrutura ARN

1. Criar um JSON arquivo CLI de entrada

   Use sua ferramenta de edição de arquivos favorita para criar um JSON arquivo com as seguintes chaves, além de valores válidos para seu ambiente. Este exemplo usa um arquivo denominado create-image-pipeline.json:

   {
   	"name": "MyWindows2019Pipeline",
   	"description": "Builds Windows 2019 Images",
   	"enhancedImageMetadataEnabled": true,
   	"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-example-recipe/2020.12.03",
   	"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
   	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/my-example-distribution-configuration",
   	"imageTestsConfiguration": {
   		"imageTestsEnabled": true,
   		"timeoutMinutes": 60
   	},
   	"schedule": {
   		"scheduleExpression": "cron(0 0 * * SUN *)",
   		"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
   	},
   	"status": "ENABLED"
   }
   

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

2. Execute o seguinte comando, usando o arquivo que você criou como entrada.

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