Cree una canalización de imágenes AMI desde AWS CLI - EC2 Image Builder

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cree una canalización de imágenes AMI desde AWS CLI

Para crear una canalización de imágenes a partir de AWS CLI, ejecute el create-image-pipeline comando con las opciones de configuración aplicables a la canalización. Tienes la opción de crear un archivo JSON que contenga toda la configuración de la canalización o de especificar la configuración en tiempo de ejecución. En esta sección, se utiliza el método del archivo de configuración JSON para simplificar el comando.

La frecuencia con la que la canalización crea una nueva imagen para incorporar las actualizaciones pendientes de la imagen base y los componentes depende de la schedule que haya configurado. Una schedule tiene los siguientes atributos:

  • scheduleExpression: establece el cronograma de ejecución de la canalización para evaluar pipelineExecutionStartCondition y determinar si se debe iniciar una compilación. El cronograma se configura con expresiones cron. Para obtener más información sobre cómo dar formato a una expresión cron en Generador de Imágenes, consulte Utilizar expresiones cron en Generador de imágenes.

  • pipelineExecutionStartCondition: determina si su canalización debe iniciar la compilación. Los valores válidos son:

    • EXPRESSION_MATCH_ONLY: la canalización creará una nueva imagen cada vez que la expresión cron coincida con la hora actual.

    • EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE: la canalización no iniciará la compilación de una nueva imagen a menos que haya cambios pendientes en su imagen base o en los componentes.

Al ejecutar el create-image-pipeline comando en el AWS CLI, muchos de los recursos de configuración son opcionales. Sin embargo, algunos de los recursos tienen requisitos condicionales, según el tipo de imagen que crea la canalización. Los siguientes identificadores de recursos son necesarios para las canalizaciones de imágenes de AMI:

  • El ARN de la receta de la imagen

  • Configuración de infraestructura ARN

 

Ejemplo: crear una imagen de Windows 2019

En este ejemplo, se configura una canalización que está programada para ejecutarse una vez a la semana los domingos. El archivo de configuración que se muestra en el primer paso utiliza los recursos existentes para la configuración de la imagen, la infraestructura y la distribución, junto con otros ajustes, para crear una imagen de Windows 2019.

  1. Cree un archivo de configuración (opcional)

    En este ejemplo, se utiliza un archivo de configuración denominado create-image-pipeline.json para configurar los ajustes en un solo lugar. Como alternativa, puede usar las opciones de la línea de comandos al ejecutar el comando para especificar todos los detalles que se muestran aquí en el archivo de configuración.

    {
	"name": "ExampleWindows2019Pipeline",
	"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

    • Debe incluir la notación file:// al principio de la ruta del archivo JSON.

    • La ruta del archivo JSON debe seguir la convención apropiada para el sistema operativo base donde se está ejecutando el comando. Por ejemplo, Windows utiliza la barra diagonal inversa (\) para referirse a la ruta de directorios, mientras que Linux y macOS usan la barra diagonal (/).

  2. Ejecute el comando para crear una imagen

    En este ejemplo, se utiliza el archivo de configuración creado en el primer paso como entrada del create-image-pipeline comando. Como alternativa, puedes especificar la configuración y los recursos de tu canalización directamente al ejecutar el comando. Para obtener más información consulte create-image-pipeline en la Referencia de la AWS CLI .

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