View a markdown version of this page

Creación de un flujo de trabajo de imágenes - 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.

Creación de un flujo de trabajo de imágenes

Cuando crea un flujo de trabajo de imágenes, tiene más control sobre el proceso de creación de imágenes. Puede especificar el flujo de trabajo que se ejecuta cuando Image Builder crea su imagen, los flujos de trabajo que se ejecutan cuando prueba la imagen y el flujo de trabajo que se ejecuta cuando la distribuye. También puede especificar una clave administrada por el cliente para cifrar los recursos del flujo de trabajo. Para obtener más información sobre el cifrado de los recursos del flujo de trabajo, consulte Cifrado y administración de claves en Generador de imágenes.

Para la creación de imágenes, puede especificar un flujo de trabajo en fase de creación, uno o más flujos de trabajo en fase de prueba y un flujo de trabajo en fase de distribución. Incluso puedes saltarte una etapa por completo, según tus necesidades. Las acciones que realiza el flujo de trabajo se configuran en el documento de definición YAML que utiliza el flujo de trabajo. Para obtener más información sobre la sintaxis de los documentos YAML, consulte Creación de un documento de flujos de trabajo YAML.

Para crear un nuevo flujo de trabajo de compilación, prueba o distribución, selecciona la pestaña que coincida con tu entorno.

Consola de administración de AWS

Puede seguir el proceso a continuación para crear un nuevo flujo de trabajo en la consola de Generador de imágenes.

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

  2. Elija Flujos de trabajo de imágenes en el panel de navegación. Se mostrará una lista de los flujos de trabajo de imágenes que su cuenta posee o a los que tiene acceso.

    nota

    La lista siempre incluye los recursos de flujo de trabajo gestionados por Amazon que Image Builder utiliza para sus flujos de trabajo predeterminados. Para ver los detalles de esos flujos de trabajo, seleccione el enlace Flujo de trabajo.

  3. Para crear un nuevo flujo de trabajo, elija Crear flujo de trabajo de imágenes. Aparece la página Crear flujo de trabajo de imágenes.

  4. Configure los detalles del nuevo flujo de trabajo. Selecciona el tipo de flujo de trabajo en la parte superior del formulario: elige Crear para crear un flujo de trabajo de creación, Probar para crear un flujo de trabajo de prueba o Distribución para crear un flujo de trabajo de distribución. El tipo de flujo de trabajo se asigna al Type valor de la API (BUILDTEST, oDISTRIBUTION). Generador de imágenes rellena la lista Plantillas en función de esta opción. Todos los demás pasos son los mismos para los flujos de trabajo de creación, prueba y distribución.

    General

    En la sección general se incluyen opciones que se aplican al recurso de flujo de trabajo, como el nombre y la descripción. La configuración general incluye lo siguiente:

    • Nombre del flujo de trabajo de imágenes (obligatorio): nombre del flujo de trabajo de imágenes. El nombre debe ser exclusivo en su cuenta. El nombre puede tener una longitud máxima de 128 caracteres. Los caracteres válidos incluyen letras, números, espacios, - y _.

    • Versión (obligatorio): versión semántica del recurso de flujo de trabajo que se va a crear (principal.secundaria.revisión).

    • Descripción (opcional): si lo desea, agregue una descripción del flujo de trabajo.

    • Clave de KMS (opcional): puede cifrar los recursos del flujo de trabajo con una clave administrada por el cliente. Para obtener más información, consulte Cifrado de flujos de trabajo de imágenes con una clave administrada por el cliente.

    Documento de definición

    El documento de flujos de trabajo YAML contiene toda la configuración del flujo de trabajo.

    Introducción

    • Para empezar con una plantilla predeterminada de Generador de imágenes como referencia para el flujo de trabajo, seleccione la opción Comenzar desde plantillas. Esta opción está seleccionada de forma predeterminada. Tras elegir qué plantilla utilizar de la lista Plantillas, se copia la configuración predeterminada de la plantilla que ha seleccionado en el Contenido del nuevo documento de flujos de trabajo, donde puede realizar cambios.

    • Para definir el documento de flujos de trabajo desde cero, seleccione la opción Empezar desde cero. El Contenido se rellena con un breve resumen de algunas partes importantes del formato del documento para ayudarlo a empezar.

    En el panel Contenido se incluye una barra de estado en la parte inferior en la que se muestran las advertencias o los errores del documento YAML. Para obtener más información sobre cómo crear un documento de flujos de trabajo YAML, consulte Creación de un documento de flujos de trabajo YAML.

  5. Cuando haya completado el flujo de trabajo, o si quiere guardar el progreso y volver a él más adelante, seleccione Crear flujo de trabajo.

AWS CLI

Antes de ejecutar el create-workflow comando en AWS CLI, debes crear el documento YAML que contiene toda la configuración de tu flujo de trabajo. Para obtener más información, consulte Creación de un documento de flujos de trabajo YAML.

En el siguiente ejemplo se muestra cómo crear un flujo de trabajo de creación con el comando create-workflow de la AWS CLI . El parámetro --data hace referencia a un documento YAML que contiene la configuración de creación del flujo de trabajo que cree.

Ejemplo: creación de un flujo de trabajo

aws imagebuilder create-workflow --name example-build-workflow --semantic-version 1.0.0 --type BUILD --data file://example-build-workflow.yml

Salida:

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/example-build-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

En el siguiente ejemplo se muestra cómo crear un flujo de trabajo de prueba con el comando create-workflow de la AWS CLI . El --data parámetro hace referencia a un documento YAML que contiene la configuración de prueba para el flujo de trabajo que creaste.

Ejemplo: creación de un flujo de trabajo de prueba

aws imagebuilder create-workflow --name example-test-workflow --semantic-version 1.0.0 --type TEST --data file://example-test-workflow.yml

Salida:

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/example-test-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

El siguiente ejemplo muestra cómo crear un flujo de trabajo de distribución con el comando https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html AWS CLI create-workflow. El --data parámetro hace referencia a un documento YAML que contiene la configuración de distribución para el flujo de trabajo que se crea.

Ejemplo: crear un flujo de trabajo de distribución 

aws imagebuilder create-workflow --name example-distribution-workflow --semantic-version 1.0.0 --type DISTRIBUTION --data file://example-distribution-workflow.yml

Salida:

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/distribution/example-distribution-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}