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. La interpolación de cadenas para variables dinámicas te permite incrustar expresiones de JSONPath en contenido estructurado, como cadenas JSON. Esto es especialmente útil cuando necesitas pasar valores de tiempo de ejecución dentro de cargas útiles complejas a acciones escalonadas como o. ExecuteStateMachine WaitForAction

Para usar la interpolación de cadenas para variables dinámicas, coloca las expresiones de JSONPath entre corchetes dobles dentro del contenido de la cadena. "{{...}}" Solo las expresiones de JSONPath envueltas entre corchetes dobles se procesan como variables. Todas las expresiones de JSONPath que no estén entre corchetes dobles se tratan como contenido de cadena literal.

Sintaxis de variables de flujo de trabajo dinámico de JSONPath

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

Los valores de las variables dinámicas se representan como selectores JSONPath con nodos estructurales que identifican de forma exclusiva la variable de destino. 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 de Generador de imágenes, imageBuilder. En la siguiente lista se incluyen los nodos de estructura de documentos de flujos de trabajo de JSONPath admitidos.

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 ejemplo, instanceId.

Cada paso puede hacer referencia a la salida de cualquier acción de paso anterior con estas variables dinámicas JSONPath. 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 1: indicador de encadenamiento de parámetros de entrada

El siguiente ejemplo muestra un parámetro de entrada que utiliza la interpolación de cadenas para resolver una variable dinámica en el valor del parámetro en tiempo de ejecución.

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

Ejemplo 2: interpolación de cadenas en variables dinámicas

El siguiente ejemplo demuestra cómo las variables dinámicas utilizan la interpolación de cadenas para determinar los valores en tiempo de ejecución.

- name: ValidateImageConfiguration
  action: ExecuteStateMachine
  inputs:
    stateMachineArn: arn:aws:states:us-east-1:111122223333:stateMachine:ImageValidation
    input: |
      {
        "imageId": "{{ $.stepOutputs.CreateImageFromInstance.imageId }}",
        "region": "us-east-1",
        "buildDate": "{{ $.imagebuilder.dateTime }}",
        "instanceType": "{{ $.stepOutputs.LaunchStep.instanceType }}"
      }

En este ejemplo, las expresiones de JSONPath envueltas entre corchetes dobles se resuelven en tiempo de ejecución:

Las cadenas literales, como, "region": "us-east-1" permanecen inalteradas.

Uso de variables del sistema de Generador de imágenes

Image Builder proporciona las siguientes variables de sistema que puede usar en su documento de flujo de trabajo. Estos son valores de solo lectura que Image Builder rellena durante el tiempo de ejecución. Se hace referencia a una variable del sistema con el nodo de estructura del imagebuilder documento, por ejemplo. $.imagebuilder.platform