Tutorial: creación de una canalización de imágenes con una imagen de contenedor de Docker de salida desde el asistente de consola de Generador de imágenes

1. Abra la consola EC2 de Image Builder en https://console.aws.amazon.com/imagebuilder/.

2. Para empezar a crear la canalización, seleccione Crear canalizaciones de imágenes.

3. En la sección General, introduzca el nombre de su canalización (obligatorio).

4. En la sección Crear programación, puede mantener los valores predeterminados de las opciones de programación. Tenga en cuenta que la zona horaria que se muestra en el horario predeterminado es la hora universal coordinada (UTC). Para obtener más información sobre la hora UTC y encontrar el desfase de su zona horaria, consulte Abreviaturas de zonas horarias: lista mundial.

   Para configurar las actualizaciones de dependencias, seleccione la opción Ejecutar la canalización a la hora programada si hay actualizaciones de dependencias. Esta configuración hace que la canalización compruebe si hay actualizaciones antes de iniciar la compilación. Si no hay actualizaciones, se omite la compilación programada de la canalización.

   nota

   Para garantizar que su proceso reconozca las actualizaciones y compilaciones de dependencias según lo previsto, debe usar el control de versiones semántico (x.x.x) para la imagen base y los componentes. Para obtener más información sobre el control de versiones semántico para los recursos de Generador de Imágenes, consulte Control de versiones semántico en Generador de imágenes.

5. Para continuar en el paso siguiente, seleccione Siguiente.

1. El valor predeterminado de Generador de Imágenes es Usar la receta existente en la sección Receta. Por primera vez, elija la opción Crear nueva receta.

2. En la sección Tipo de imagen, elija la opción imagen de Docker para crear una canalización de contenedores que genere una imagen de Docker y la distribuya a los repositorios de Amazon ECR de las regiones de destino.

3. En la sección General, introduzca las siguientes casillas obligatorias:

   • Nombre: el nombre de su receta

   • versión: la versión de su receta (use el formato) <major>.<minor>.<patch>, donde major, minor y patch son valores enteros). Por lo general, las recetas nuevas comienzan con 1.0.0.

4. En la sección Imagen de origen, mantenga los valores predeterminados para Seleccionar imagen, Sistema operativo (SO) de la imagen y Origen de la imagen. El resultado es una lista de imágenes de contenedor de Amazon Linux 2, administradas de Amazon, entre las que puede elegir para su imagen base.

   1. En el menú desplegable Nombre de la imagen, elija una imagen.

   2. Mantenga el valor predeterminado para las opciones de control de versiones automático (utilice la última versión del sistema operativo disponible).

      nota

      Esta configuración garantiza que la canalización utilice el control de versiones semántico para la imagen base, a fin de detectar las actualizaciones de dependencias en los trabajos programados automáticamente. Para obtener más información sobre el control de versiones semántico para los recursos de Generador de Imágenes, consulte Control de versiones semántico en Generador de imágenes.

5. En la sección Componentes, debe elegir al menos un componente de compilación.

   En el panel Componentes de compilación: Amazon Linux, puede navegar por los componentes que aparecen en la página. Utilice el control de paginación situado en la esquina superior derecha para navegar por los componentes adicionales que están disponibles para su sistema operativo de imagen base. También puede buscar componentes específicos o crear su propio componente de compilación mediante el administrador de componentes.

   Para este tutorial, elija un componente que actualice Linux con las actualizaciones de seguridad más recientes, de la siguiente manera:

   1. Filtre los resultados introduciendo la palabra update en la barra de búsqueda que se encuentra en la parte superior del panel.

   2. Seleccione la casilla de verificación del componente de compilación update-linux.

   3. Desplácese hacia abajo y, en la esquina superior derecha de la lista de componentes seleccionados, elija Expandir todo.

   4. Mantenga el valor predeterminado para las opciones de control de versiones (utilice la última versión del componente disponible).

      nota

      Esta configuración garantiza que la canalización utilice el control de versiones semántico para el componente seleccionado a fin de detectar las actualizaciones de dependencias en los trabajos programados automáticamente. Para obtener más información sobre el control de versiones semántico para los recursos de Generador de Imágenes, consulte Control de versiones semántico en Generador de imágenes.

      Si ha seleccionado un componente que tiene parámetros de entrada, también verá los parámetros en esta área. No se abordan los parámetros en este tutorial. Para obtener más información sobre el uso de parámetros de entrada en los componentes y su configuración en las recetas, consulte Tutorial: creación de un documento del componente con los parámetros de entrada.

   Reordenar los componentes (opcional)

   Si ha elegido más de un componente para incluirlos en la imagen, puede utilizar la drag-and-drop acción para reorganizarlos en el orden en que deben ejecutarse durante el proceso de creación.

   nota

   Los componentes de endurecimiento del CIS no siguen las reglas de ordenación de componentes estándar de las recetas de Generador de Imágenes. Los componentes de endurecimiento del CIS siempre se ejecutan en último lugar para garantizar que las pruebas de referencia se ejecuten con la imagen de salida.

   1. Vuelva a la lista de componentes disponibles.

   2. Seleccione la casilla de verificación del componente de compilación update-linux-kernel-mainline (o cualquier otro componente que elija).

   3. Desplácese hacia abajo hasta la lista de componentes seleccionados para comprobar que haya al menos dos resultados.

   4. Es posible que no se haya ampliado el control de versiones de los componentes recién agregados. Para ampliar las opciones de control de versiones, puede seleccionar la flecha junto a las opciones de control de versiones o puede activar y desactivar la opción Expandir todo para ampliar el control de versiones de todos los componentes seleccionados.

   5. Elija uno de los componentes y arrástrelo hacia arriba o hacia abajo para cambiar el orden en el que se ejecutarán los componentes.

   6. Para eliminar el componente update-linux-kernel-mainline, seleccione X en la esquina superior derecha del cuadro de componentes.

   7. Repita el paso anterior para eliminar cualquier otro componente que haya añadido, y deje solo el componente update-linux seleccionado.

6. En la sección de plantilla de Dockerfile, seleccione la opción Usar ejemplo. En el panel de contenido, observe las variables contextuales en las que Generador de Imágenes coloca información de compilación o scripts, basándose en la receta de la imagen de contenedor.

   De forma predeterminada, Generador de imágenes utiliza las siguientes variables contextuales en el Dockerfile.

    

   parentImage (obligatorio)

   En el momento de la compilación, esta variable se convierte en la imagen base de la receta.

   Ejemplo:

   FROM
   {{{ imagebuilder:parentImage }}}

   entornos (obligatorio si se especifican los componentes)

   Esta variable se convertirá en un script que ejecuta componentes.

   Ejemplo:

   {{{ imagebuilder:environments }}}

   componentes (opcional)

   Generador de imágenes resuelve los scripts de componentes de compilación y prueba para los componentes que incluye la receta del contenedor. Esta variable se puede colocar en cualquier parte del Dockerfile, después de la variable de entorno.

   Ejemplo:

   {{{ imagebuilder:components }}}

7. En la sección Repositorio de destino, especifique el nombre del repositorio de Amazon ECR que creó como requisito previo para este tutorial. Este repositorio se utiliza como configuración predeterminada para la configuración de distribución en la región donde se ejecuta la canalización (región 1).

   nota

   El repositorio de destino debe existir en Amazon ECR en todas las regiones de destino antes de la distribución.

8. Para continuar en el paso siguiente, seleccione Siguiente.

• Para continuar en el paso siguiente, seleccione Siguiente.

• Para continuar en el paso siguiente, seleccione Siguiente.

1. Cuando haya revisado la configuración, seleccione Crear canalización para crear su canalización.

2. Puede ver los mensajes de éxito o falla en la parte superior de la página, a medida que se crean los recursos para los ajustes de la distribución, la configuración de la infraestructura, la nueva receta y la canalización. Para ver los detalles de un recurso, incluido el identificador del recurso, seleccione Ver detalles.

3. Después de ver los detalles de un recurso, puede ver los detalles de otros recursos seleccionando el tipo de recurso en el panel de navegación. Por ejemplo, para ver los detalles de su nueva canalización, seleccione Canalizaciones de imágenes en el panel de navegación. Si la compilación se realizó correctamente, la nueva canalización se mostrará en la lista de canalizaciones de imágenes.

Eliminación de la canalización

1. Para ver una lista de las canalizaciones de compilación creadas en su cuenta, seleccione las canalizaciones de imágenes en el panel de navegación.

2. Seleccione la casilla de verificación junto al nombre de canalización para seleccionar la canalización que desea eliminar.

3. En la parte superior del panel Canalizaciones de imágenes, en el menú Acciones, seleccione Eliminar.

4. Para confirmar la eliminación, ingrese Delete en el cuadro y seleccione Eliminar.

Eliminación de la receta de contenedor

1. Para ver una lista de las recetas de contenedor creadas en su cuenta, seleccione Recetas de contenedor en el panel de navegación.

2. Seleccione la casilla de verificación junto al nombre de la receta para seleccionar la receta que desea eliminar.

3. En la parte superior del panel Recetas de contenedor, en el menú Acciones, seleccione Eliminar receta.

4. Para confirmar la eliminación, ingrese Delete en el cuadro y seleccione Eliminar.

Eliminación de configuración de infraestructura

1. Para ver una lista de las configuraciones de infraestructura creadas en su cuenta, seleccione Configuración de infraestructura en el panel de navegación.

2. Seleccione la casilla de verificación junto al nombre de la configuración para seleccionar la configuración de infraestructura que desea eliminar.

3. En la parte superior del panel Configuraciones de infraestructura, seleccione Eliminar.

4. Para confirmar la eliminación, ingrese Delete en el cuadro y seleccione Eliminar.

Eliminación de ajustes de distribución

1. Para ver una lista de los ajustes de distribución creados en su cuenta, seleccione Ajustes de distribución en el panel de navegación.

2. Seleccione la casilla de verificación junto al nombre de la configuración para seleccionar los ajustes de distribución que creó para este tutorial.

3. En la parte superior del panel Ajustes de distribución, seleccione Eliminar.

4. Para confirmar la eliminación, ingrese Delete en el cuadro y seleccione Eliminar.

1. Para ver una lista de las imágenes creadas en su cuenta, seleccione Imágenes en el panel de navegación.

2. Elija la versión de la imagen que desea eliminar. Esto abre la página Versiones de compilación de imágenes.

3. Seleccione la casilla de verificación junto a la versión de cualquier imagen que desea eliminar. Puede seleccionar más de una versión de imagen a la vez.

4. En la parte superior del panel Versiones de compilación de imágenes, seleccione Eliminar versión.

5. Para confirmar la eliminación, ingrese Delete en el cuadro y seleccione Eliminar.