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