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.

# Tutorial: creación de una canalización de imágenes con una AMI de salida desde el asistente de la consola de Generador de Imágenes
<a name="start-build-image-pipeline"></a>

En este tutorial se explica cómo crear una canalización automatizada para crear y mantener una imagen personalizada de Generador de Imágenes de EC2 mediante el asistente de consola **Crear canalizaciones de imágenes**. Para ayudarle a realizar los pasos de forma eficaz, se utilizan los ajustes predeterminados cuando están disponibles y se omiten las secciones opcionales.

**Topics**
+ [Paso 1: especificar los detalles de canalización](#start-build-image-step1)
+ [Paso 2: elegir receta](#start-build-image-step2)
+ [Paso 3: definir la configuración de la infraestructura (opcional)](#start-build-image-step3)
+ [Paso 4: definir los ajustes de distribución (opcional)](#start-build-image-step4)
+ [Paso 5: Revisar](#start-build-image-step5)
+ [Paso 6: limpiar](#start-build-image-cleanup)

## Paso 1: especificar los detalles de canalización
<a name="start-build-image-step1"></a>

1. Abra la consola [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)EC2 Image Builder en.

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

1. En la sección **General**, introduzca el **nombre de su canalización** (*obligatorio*).
**sugerencia**  
La recopilación mejorada de metadatos está activada de forma predeterminada. Para garantizar la compatibilidad entre los componentes y las imágenes base, manténgala activada.

1. 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](https://www.timeanddate.com/time/zones/).

   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](ibhow-semantic-versioning.md).

1. Para continuar en el paso siguiente, seleccione **Siguiente**.

## Paso 2: elegir receta
<a name="start-build-image-step2"></a>

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**.

1. En la sección **Tipo de imagen**, elija la opción **Imagen de máquina de Amazon (AMI)** para crear una canalización de imágenes que produzca y distribuya una AMI.

1. 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`.

1. 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**. Esto da como resultado una lista de Linux AMIs gestionados por Amazon. Para este tutorial, selecciona la `Amazon Linux 2 x86` imagen.

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

   1. 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](ibhow-semantic-versioning.md).

1. En la sección **Configuración de instancias**, conserve los valores predeterminados de **Systems Manager Agent**. Esto hace que Generador de Imágenes conserve el agente de Systems Manager una vez finalizadas la compilación y las pruebas, para incluir Systems Manager Agent en la nueva imagen.

   Mantenga **los datos de usuario** en blanco para este tutorial. Puede utilizar esta área en otras ocasiones para proporcionar comandos o un script de comandos para que se ejecuten al lanzar la instancia de compilación. Sin embargo, reemplaza cualquier comando que Generador de Imágenes haya agregado para garantizar que Systems Manager esté instalado. Cuando lo utilice, asegúrese de que el agente de Systems Manager esté preinstalado en la imagen base o de que incluya la instalación en los datos de usuario.

1. En la sección **Componentes**, puede optar por no añadir ningún componente y continuar. Si desea añadir componentes, en el panel **Construir componentes**, elija **Añadir componentes de construcción y selecciónelos en la lista `Amazon managed` de filtros de propietarios de componentes**. Se abre un panel de selección en la parte derecha de la interfaz de la consola donde puede buscar y filtrar los componentes que están disponibles.

   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.

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

   1. Mantenga las **opciones de control de versiones** predeterminadas (**utilice la última versión 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](ibhow-semantic-versioning.md).

   1. Seleccione **Añadir a la receta** para añadir el componente a la receta. Esto cierra el panel de selección de componentes.

   1. De vuelta en el panel **Construir componentes**, se muestra el componente que ha añadido.

1. 

**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 el que deberían 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. Repite los pasos anteriores para añadir el `update-linux-kernel-5` componente a la receta.

   1. El componente que acaba de añadir tiene un parámetro de entrada para la versión del núcleo. Para ampliar la configuración de las **opciones de control de versiones** o los **parámetros de entrada**, puede seleccionar la flecha junto al nombre de la configuración. Para ampliar todos los ajustes de todos los componentes seleccionados, puede activar y desactivar el interruptor **Expandir todo**. 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](tutorial-component-parameters.md).

   1. 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.

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

      Repita este paso para eliminar cualquier otro componente que haya agregado, dejando solo el `update-linux` componente seleccionado.

1. Para continuar en el paso siguiente, seleccione **Siguiente**.

## Paso 3: definir la configuración de la infraestructura (opcional)
<a name="start-build-image-step3"></a>

Generador de Imágenes lanza instancias de EC2 en su cuenta para personalizar las imágenes y ejecutar pruebas de validación. Los ajustes de configuración de la infraestructura especifican los detalles de la infraestructura de las instancias que se ejecutarán en su Cuenta de AWS servidor durante el proceso de creación.

En la sección **Configuración de infraestructura**, las **opciones de configuración** están predeterminadas en `Create infrastructure configuration using service defaults`. Esto crea un rol de IAM y un perfil de instancia asociado para las instancias de compilación y prueba de EC2 que se utilizan para configurar la imagen. Para obtener más información sobre los ajustes de configuración de la infraestructura, consulte [CreateInfrastructureConfiguration](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateInfrastructureConfiguration.html)la referencia de la *API de EC2 Image Builder*.

En este tutorial, utilizamos la configuración predeterminada.

**nota**  
Para especificar una subred para usarla en una VPC privada, puede crear su propia configuración de infraestructura personalizada o usar los ajustes que ya haya creado.
+ Para continuar en el paso siguiente, seleccione **Siguiente**.

## Paso 4: definir los ajustes de distribución (opcional)
<a name="start-build-image-step4"></a>

Las configuraciones de distribución incluyen el nombre de la AMI de salida, la configuración regional específica para el cifrado, los permisos de lanzamiento y Cuentas de AWS las organizaciones y unidades organizativas (OUs) que pueden lanzar la AMI de salida y las configuraciones de licencia.

En la sección **Ajustes de distribución**, las **opciones de configuración** están predeterminadas en `Create distribution settings using service defaults`. Esta opción distribuirá la AMI de salida a la región actual. Para obtener más información acerca de los ajustes de su distribución, consulte [Administrar los ajustes de la distribución de Generador de imágenes](manage-distribution-settings.md).

En este tutorial, utilizamos la configuración predeterminada.
+ Para continuar en el paso siguiente, seleccione **Siguiente**.

## Paso 5: Revisar
<a name="start-build-image-step5"></a>

La sección de **revisión** muestra todos los ajustes que ha configurado. Para editar la información de una sección determinada, presione el botón **Editar** situado en la esquina superior derecha de la sección de pasos. Por ejemplo, si quiere cambiar el nombre de la canalización, presione el botón **Editar** en la esquina superior derecha de la sección **Paso 1: detalles de la canalización**.

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

1. 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**.

1. 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**.

## Paso 6: limpiar
<a name="start-build-image-cleanup"></a>

Su entorno Generador de Imágenes, al igual que su hogar, necesita un mantenimiento habitual para ayudarlo a encontrar lo que necesita y completar sus tareas sin tener que preocuparse por el desorden. Asegúrese de limpiar periódicamente los recursos temporales que creó para las pruebas. De lo contrario, es posible que se olvide de esos recursos y, más adelante, no recuerde para qué se utilizaron. Para entonces, es posible que no esté claro si puede deshacerse de ellos de manera segura.

**sugerencia**  
Para evitar errores de dependencia al eliminar recursos, asegúrese de eliminarlos en el siguiente orden:  
Canalización de imágenes
Receta de imagen
Todos los recursos restantes

Siga los pasos de esta sección para eliminar los recursos que ha creado en este tutorial:

**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.

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

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

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

**Eliminación de la receta**

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

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

1. En la parte superior del panel **Recetas de imagen**, en el menú **Acciones**, seleccione **Eliminar receta**.

1. 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.

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

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

1. 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.

1. 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.

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

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

**Eliminación de la imagen**  
Siga estos pasos para comprobar que ha eliminado cualquier imagen que se haya creado de la canalización del tutorial. No es probable que este tutorial cree una imagen a menos que haya transcurrido suficiente tiempo desde que creó la canalización para que se ejecute, de acuerdo con el cronograma de compilación.

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

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

1. 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.

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

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