Utilisez des variables dynamiques dans votre document de flux de travail

Vous pouvez utiliser des variables dynamiques dans vos documents de flux de travail pour représenter des valeurs qui varient au moment de l'exécution de votre processus de création d'images. L'interpolation de chaînes pour les variables dynamiques vous permet d'intégrer des expressions JSONPath dans du contenu structuré tel que des chaînes JSON. Cela est particulièrement utile lorsque vous devez transmettre des valeurs d'exécution dans des charges utiles complexes à des actions d'étape telles que ou. ExecuteStateMachine WaitForAction

Pour utiliser l'interpolation de chaînes pour les variables dynamiques, placez les expressions JSONPath entre accolades "{{...}}" doubles dans le contenu de votre chaîne. Seules les expressions JSONPath entourées de doubles accolades sont traitées comme des variables. Toutes les expressions JSONPath qui ne sont pas entourées de doubles accolades sont traitées comme du contenu de chaîne littéral.

Syntaxe des variables de flux de travail dynamiques JSONPath

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

Les valeurs des variables dynamiques sont représentées sous forme de sélecteurs JSONPath avec des nœuds structurels qui identifient de manière unique la variable cible. Le premier nœud après la racine ($) fait référence à la structure du document du flux de travail, telle que, dans le cas des variables système Image BuilderstepOutputs, ou dans le cas des variables système Image Builder,imageBuilder. La liste suivante contient les nœuds de structure de document de flux de travail JSONPath pris en charge.

Les nœuds parameters et la structure du stepOutputs document incluent un nœud facultatif pour le nom de l'étape. Cela permet de garantir des noms de variables uniques à toutes les étapes.

Le nœud final du JSONPath est le nom de la variable cible, par exemple. instanceId

Chaque étape peut faire référence à la sortie de toute action d'étape précédente avec ces variables dynamiques JSONPath. Ceci est également connu sous le nom de chaînage ou de référencement. Pour faire référence à la sortie d'une action d'étape précédente, vous pouvez utiliser la variable dynamique suivante.

$.stepOutputs.step-name.output-name

Exemple 1 : indicateur de chaînage des paramètres d'entrée

L'exemple suivant montre un paramètre d'entrée qui utilise l'interpolation de chaîne pour résoudre une variable dynamique dans la valeur du paramètre au moment de l'exécution.

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

Exemple 2 : interpolation de chaînes dans des variables dynamiques

L'exemple suivant montre comment les variables dynamiques utilisent l'interpolation de chaînes pour déterminer les valeurs au moment de l'exécution.

- 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 }}"
      }

Dans cet exemple, les expressions JSONPath entourées de doubles accolades sont résolues au moment de l'exécution :

Les chaînes littérales like "region": "us-east-1" restent inchangées.

Utiliser les variables système Image Builder

Image Builder fournit les variables système suivantes que vous pouvez utiliser dans votre document de flux de travail. Il s'agit de valeurs en lecture seule qu'Image Builder renseigne lors de l'exécution. Vous faites référence à une variable système avec le nœud de structure du imagebuilder document, par exemple$.imagebuilder.platform.