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 las capacidades de distribución de AMI mejoradas
Image Builder ofrece funciones de distribución avanzadas que le brindan flexibilidad y control sobre cómo se distribuyen las AMI entre las regiones y las cuentas. Estas capacidades separan la distribución del proceso de creación, lo que le permite distribuir las imágenes existentes bajo demanda, recuperarse de los errores de distribución de manera eficiente e implementar estrategias de distribución controladas en varias etapas mediante flujos de trabajo personalizables.
Puede utilizar las funciones de distribución de AMI mejoradas en 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 -
Versión ARN de Image Builder: versión ARN de una imagen de Image Builder
Reintento de distribución
Si la distribución de una imagen falla, usa 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 una versión ARN de creació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 en que se produjo el error utilizando la configuración y los ajustes de distribución originales. La RetryImage API puede reintentar las distribuciones que fallaron durante la fase de distribución, la fase de prueba o la fase de integración. Funciona con las AMI en los siguientes estados: pendientes, fallidas, eliminadas o disponibles.
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. Revisa los registros de distribución en CloudWatch Logs para ver los detalles de los errores.
-
Tienes los permisos de IAM necesarios para volver a intentar crear la imagen.
-
EC2ImageBuilderDistributionCrossAccountRoleEn caso de errores de distribución entre cuentas, compruebe que la política esté asociada a laEc2ImageBuilderCrossAccountDistributionAccesscuenta de destino.
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 las operaciones de copia de la AMI, los puntos de control en espera de la acción, las modificaciones de los atributos de las imágenes y otros pasos relacionados con la distribución. Esto proporciona un control estructurado sobre la forma en que se distribuyen las AMI, con una visibilidad escalonada, capacidades de distribución paralela e informes de errores granulares.
Para obtener más información sobre la creación y personalización de flujos de trabajo, consulte Administrar flujos de trabajo de imágenes.
