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: |
Cadena |
|
cloudWatchLogTransmisión |
El nombre del flujo de CloudWatch registros para los registros de salida. |
Cadena |
|
collectImageMetadata |
Configuración que indica al Generador de imágenes si debe recopilar metadatos de la instancia. |
Booleano |
|
collectImageScanHallazgos |
Valor actual de la configuración que permite al Generador de imágenes recopilar los resultados del análisis de imágenes. |
Booleano |
|
imageBuildNumber |
Número de versión de creación de la imagen. |
Entero |
|
imageId |
El AMI identificador de la imagen base. |
Cadena |
|
imageName |
El nombre de la imagen. |
Cadena |
|
imageType |
Tipo de salida de la imagen. |
Cadena |
|
imageVersionNumber |
Número de versión de la imagen. |
Cadena |
|
instanceProfileName |
Nombre del rol de perfil de instancia que el Generador de imágenes utiliza para lanzar instancias de creación y prueba. |
Cadena |
|
platform |
Plataforma del sistema operativo de la imagen que se crea. |
Cadena |
|
s3Logs |
JSONObjeto que contiene la configuración de los registros de S3 que escribe Image Builder. |
JSONobjeto |
{'s3logs': {'s3 BucketName ':' |
securityGroups |
El grupo de seguridad IDs que se aplica a las instancias de creación y prueba. |
Lista [cadena] |
|
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: |
subnetId |
ID de la subred en la que se lanzan las instancias de creación y prueba. |
Cadena |
|
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 |
|
workflowPhase |
Etapa actual que se ejecuta para la ejecución del flujo de trabajo. |
Cadena |
|
workingDirectory |
Ruta al directorio de trabajo. |
Cadena |
|