Utilice capacidades de distribución de AMI mejoradas - 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.

Utilice capacidades de distribución de AMI mejoradas

Image Builder ofrece funciones de distribución avanzadas que le proporcionan flexibilidad y control sobre la forma en AMIs que se distribuyen entre regiones y cuentas. Estas capacidades separan la distribución del proceso de creación, lo que le permite distribuir las imágenes existentes a pedido, recuperarse de los errores de distribución de manera eficiente e implementar estrategias de distribución controladas y en varias etapas mediante flujos de trabajo personalizables.

Puede utilizar las funciones de distribución de AMI mejoradas de Image Builder para realizar directamente las actividades de distribución sin necesidad de volver a ejecutar una creación de imagen completa.

Distribución desacoplada

La DistributeImage API acepta tres tipos de referencias a imágenes de origen:

  • ID de AMI: un identificador de AMI estándar (por ejemplo,ami-0abcdef1234567890)

  • Parámetro SSM: parámetro SSM que almacena un ID de AMI (por ejemplo,) ssm:/my/ami/parameter

  • Image Builder versión ARN: versión de imagen ARN de Image Builder

Reintento de distribución

Si se produce un error en la distribución de una imagen, utilice la RetryImage API para volver a intentarlo. Esto reduce el tiempo necesario para solucionar la causa del error al evitar una reconstrucción completa de la imagen. Úselo RetryImage después de resolver la causa subyacente del error de distribución.

La RetryImage API acepta un ARN de la versión de compilación de imágenes (por ejemplo,arn:aws:imagebuilder:us-west-2:123456789012:image/my-image/1.0.0/1). Al invocar la API, Image Builder reanuda automáticamente el proceso de distribución desde el punto del error utilizando la configuración y los ajustes de distribución originales. La RetryImage API puede volver a intentar las distribuciones que fallaron durante la fase de distribución, la fase de prueba o la fase de integración. Funciona AMIs en los siguientes estados: pendiente, fallido, eliminado o disponible.

Requisitos previos

Antes de volver a intentar una distribución, asegúrese de lo siguiente:

  • Ha identificado y resuelto la causa raíz del error. Revise los registros de distribución en CloudWatch Logs para ver los detalles del error.

  • Dispone de los permisos de IAM necesarios para volver a intentar crear la imagen.

  • En caso de errores en la distribución entre cuentas, compruebe que EC2ImageBuilderDistributionCrossAccountRole la cuenta de destino tenga la Ec2ImageBuilderCrossAccountDistributionAccess política adjunta.

Importante: si vuelve a intentarlo sin solucionar el problema subyacente, se producirán errores repetidos.

flujos de trabajo de distribución

Los flujos de trabajo de distribución son un nuevo tipo de flujo de trabajo que complementa los flujos de trabajo de creación y prueba, lo que permite definir y controlar el proceso de distribución con pasos secuenciales. Con los flujos de trabajo de distribución, puede crear procesos de distribución personalizados que incluyan operaciones de copia de la AMI, wait-for-action puntos de control, modificaciones de atributos de imagen y otros pasos relacionados con la distribución. Esto proporciona un control estructurado sobre la forma en AMIs que se distribuye, con visibilidad escalonada, capacidades de distribución paralela e informes de errores detallados.

Para obtener más información sobre cómo crear y personalizar flujos de trabajo, consulte Administrar flujos de trabajo de imágenes.