Usa componentes para personalizar tu imagen de Image Builder - Generador de Imágenes de EC2

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.

Usa componentes para personalizar tu imagen de Image Builder

Image Builder utiliza la aplicación de administración de componentes Ejecutor y orquestador de tareas de AWS (TOE de AWS) para organizar flujos de trabajo complejos. Los componentes de compilación y prueba que funcionan con la aplicación TOE de AWS se basan en documentos YAML que definen los scripts para personalizar o probar su imagen. Para las imágenes de AMI, Image Builder instala los componentes y la aplicación de administración de TOE de AWS componentes en sus instancias de compilación y prueba de Amazon EC2. En el caso de las imágenes de contenedores, los TOE de AWS componentes y la aplicación de administración de componentes se instalan dentro del contenedor en ejecución.

Image Builder se utiliza TOE de AWS para realizar todas las actividades en la instancia. No se requiere ninguna configuración adicional con la que interactuar TOE de AWS al ejecutar comandos de Image Builder o utilizar la consola de Image Builder.

nota

Cuando un componente administrado por Amazon llega al final de su vida útil de soporte, deja de recibir mantenimiento. Aproximadamente cuatro semanas antes de que esto ocurra, todas las cuentas que utilicen el componente recibirán una notificación de parte de su AWS Health Dashboard y una lista de las recetas afectadas de su cuenta. Para obtener más información AWS Health, consulte la Guía AWS Health del usuario.

Etapas del flujo de trabajo para compilar una nueva imagen

El flujo de trabajo de Generador de Imágenes para compilar nuevas imágenes incluye las siguientes dos etapas distintas.

  1. Etapa de compilación (previa a la instantánea): durante la etapa de compilación, usted realiza cambios en la instancia de compilación de Amazon EC2 en la que se ejecuta su imagen base para crear la base de referencia de su nueva imagen. Por ejemplo, la receta puede incluir componentes que instalen una aplicación o modifiquen la configuración del firewall del sistema operativo.

    Las siguientes fases del documento de componentes se ejecutan durante la fase de creación:

    • build

    • validar

    Una vez que esta etapa se complete correctamente, Generador de Imágenes crea una instantánea o imagen de contenedor que utilizará para la etapa de prueba y posteriores.

  2. Etapa de prueba (posterior a la instantánea): durante la etapa de prueba, existen algunas diferencias entre las imágenes que crean imágenes de AMI y de contenedor. En el caso de los flujos de trabajo de AMI, el Generador de imágenes lanza una instancia de EC2 a partir de la instantánea que creó como paso final de la etapa de creación. Las pruebas se ejecutan en la nueva instancia para validar la configuración y garantizar que la instancia funcione según lo previsto. En el caso de los flujos de trabajo de contenedor, las pruebas se ejecutan en la misma instancia que se utilizó para la creación.

    La siguiente fase del documento de componentes se ejecuta para cada componente que se incluye en la receta durante la fase de prueba de creación de la imagen:

    • prueba

    Esta fase de los componentes se aplica a los tipos de componentes de compilación y prueba. Una vez que esta etapa se complete correctamente, Generador de Imágenes podrá crear y distribuir su imagen final a partir de la instantánea o la imagen de contenedor.

nota

Si bien el marco de la TOE de AWS aplicación permite definir muchas fases en un documento de componentes, Image Builder tiene reglas estrictas sobre qué fases ejecuta y durante qué etapas las ejecuta. Para que un componente se ejecute durante la fase de creación de la imagen, el documento del componente debe definir al menos una de estas fases: build o validate Para que un componente se ejecute durante la fase de prueba de imagen, el documento del componente debe definir la test fase y no otras fases.

Como Generador de Imágenes ejecuta las etapas de forma independiente, el encadenamiento de referencias en los documentos de los componentes no puede cruzar los límites de las etapas. No puede encadenar un valor de una fase que se ejecuta en la etapa de compilación a una fase que se ejecuta en la etapa de prueba. Sin embargo, puede definir los parámetros de entrada para el objetivo deseado y transferir los valores a través de la línea de comandos. Para obtener más información sobre cómo configurar los parámetros de los componentes en sus recetas de Generador de Imágenes, consulte Tutorial: Cree un componente personalizado con parámetros de entrada de EC2 Image Builder.

Para ayudarte a solucionar problemas en tu instancia de compilación o prueba, TOE de AWS crea una carpeta de registro que contenga el documento de entrada y los archivos de registro para hacer un seguimiento de lo que ocurre cada vez que se ejecuta un componente. Si configuró un bucket de Amazon S3 en la configuración de su canalización, los registros también se escriben allí. Para obtener más información acerca de los documentos YAML y la salida de registros, consulte Utilice el marco de documentos de TOE de AWS componentes para componentes personalizados.

sugerencia

Cuando tiene muchos componentes de los que realizar un seguimiento, el etiquetado le ayuda a identificar un componente o versión específicos en función de las etiquetas que les haya asignado. Para obtener más información sobre cómo etiquetar los recursos mediante los comandos de Image Builder de AWS CLI, consulte la Etiquetar recursos sección de esta guía.

En esta sección se explica cómo enumerar, ver, crear e importar componentes mediante la consola de Generador de Imágenes o los comandos de la AWS CLI.