Uso de variables dinámicas en el documento de flujos de trabajo - EC2Image Builder

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.

Uso de variables dinámicas en el documento de flujos de trabajo

Puede utilizar variables dinámicas en los documentos de flujos de trabajo para representar valores que varían en tiempo de ejecución para el proceso de creación de imágenes. Los valores de las variables dinámicas se representan como JSONPath selectores con nodos estructurales que identifican de forma única la variable objetivo.

JSONPathestructura variable de flujo de trabajo dinámico

$.<document structure>.[<step name>].<variable name>

El primer nodo después de la raíz ($) hace referencia a la estructura del documento de flujos de trabajo; por ejemplo, stepOutputs o, en el caso de las variables del sistema del Generador de imágenes, imageBuilder. La siguiente lista contiene los nodos de estructura JSONPath de documentos de flujo de trabajo compatibles.

Nodos de estructura de documentos
  • parameters: parámetros del flujo de trabajo

  • stepOutputs - Resultados de un paso del mismo documento de flujo de trabajo

  • workflowOutputs - Resultados de un documento de flujo de trabajo que ya se ha ejecutado

  • imagebuilder: variables del sistema del Generador de imágenes

Los nodos parameters y stepOutputs de estructura de documentos incluyen un nodo opcional para el nombre del paso. Esto ayuda a garantizar que los nombres de las variables sean únicos en todos los pasos.

El último nodo de JSONPath es el nombre de la variable de destino, por ejemploinstanceId.

Cada paso puede hacer referencia al resultado de cualquier acción del paso anterior con estas variables JSONPath dinámicas. Esto también se conoce como encadenamiento o referencia. Para hacer referencia a la salida de una acción de paso anterior, puede utilizar la siguiente variable dinámica.

$.stepOutputs.step-name.output-name

Ejemplo

- name: ApplyTestComponents action: ExecuteComponents onFailure: Abort inputs: instanceId.$: "$.stepOutputs.LaunchTestInstance.instanceId"

Uso de variables del sistema del Generador de imágenes

El Generador de imágenes proporciona las siguientes variables de sistema que puede utilizar en el documento de flujos de trabajo:

Nombre de variable

Descripción

Tipo

Ejemplo de valor

cloudWatchLogAgrupar

El nombre del grupo de CloudWatch registros para los registros de salida.

Formato: /aws/imagebuilder/<recipe-name>

Cadena

/aws/imagebuilder/sampleImageRecipe

cloudWatchLogTransmisión

El nombre del flujo de CloudWatch registros para los registros de salida.

Cadena

1.0.0/1

collectImageMetadata

Configuración que indica al Generador de imágenes si debe recopilar metadatos de la instancia.

Booleano

true | false

collectImageScanHallazgos

Valor actual de la configuración que permite al Generador de imágenes recopilar los resultados del análisis de imágenes.

Booleano

true | false

imageBuildNumber

Número de versión de creación de la imagen.

Entero

1

imageId

El AMI identificador de la imagen base.

Cadena

ami-1234567890abcdef1

imageName

El nombre de la imagen.

Cadena

sampleImage

imageType

Tipo de salida de la imagen.

Cadena

AMI | Docker

imageVersionNumber

Número de versión de la imagen.

Cadena

1.0.0

instanceProfileName

Nombre del rol de perfil de instancia que el Generador de imágenes utiliza para lanzar instancias de creación y prueba.

Cadena

SampleImageBuilderInstanceProfileRole

platform

Plataforma del sistema operativo de la imagen que se crea.

Cadena

Linux | Windows | MacOS

s3Logs

JSONObjeto que contiene la configuración de los registros de S3 que escribe Image Builder.

JSONobjeto

{'s3logs': {'s3 BucketName ':'sample-bucket', KeyPrefix 's3': 'ib-logs'}}

securityGroups

El grupo de seguridad IDs que se aplica a las instancias de creación y prueba.

Lista [cadena]

[sg-1234567890abcdef1, sg-11112222333344445]

sourceImageARN

El nombre del recurso de Amazon (ARN) del recurso de imagen de Image Builder que el flujo de trabajo utiliza para las etapas de compilación y prueba.

Cadena

arn:aws:imagebuilder:us-east-1:111122223333:image/sampleImage/1.0.0/1

subnetId

ID de la subred en la que se lanzan las instancias de creación y prueba.

Cadena

subnet-1234567890abcdef1

terminateInstanceOnFallo

Valor actual de la configuración que indica al Generador de imágenes que termine la instancia en caso de error o que la conserve para la solución de problemas.

Booleano

true | false

workflowPhase

Etapa actual que se ejecuta para la ejecución del flujo de trabajo.

Cadena

Build | Test

workingDirectory

Ruta al directorio de trabajo.

Cadena

/tmp