Utilizzate le variabili dinamiche nel documento del flusso di lavoro

È possibile utilizzare variabili dinamiche nei documenti del flusso di lavoro per rappresentare valori che variano in fase di esecuzione per il processo di creazione dell'immagine. L'interpolazione delle stringhe per le variabili dinamiche consente di incorporare espressioni JSONPath all'interno di contenuti strutturati come le stringhe JSON. Ciò è particolarmente utile quando è necessario passare valori di runtime all'interno di payload complessi ad azioni step come o. ExecuteStateMachine WaitForAction

Per utilizzare l'interpolazione di stringhe per le variabili dinamiche, racchiudi le espressioni JSONPath tra doppie parentesi graffe all'interno del contenuto della stringa. "{{...}}" Solo le espressioni JSONPath racchiuse tra parentesi graffe doppie vengono elaborate come variabili. Tutte le espressioni JSONPath non racchiuse tra doppie parentesi graffe vengono trattate come contenuto di stringa letterale.

Sintassi della variabile del flusso di lavoro dinamico JSONPath

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

I valori delle variabili dinamiche sono rappresentati come selettori JSONPath con nodi strutturali che identificano in modo univoco la variabile di destinazione. Il primo nodo dopo la radice ($) si riferisce alla struttura del documento del flusso di lavoro, ad esempio ostepOutputs, nel caso delle variabili di sistema di Image Builder,. imageBuilder L'elenco seguente contiene i nodi della struttura dei documenti del flusso di lavoro JSONPath supportati.

I nodi della struttura stepOutputs del documento parameters e includono un nodo opzionale per il nome del passaggio. Questo aiuta a garantire nomi di variabili univoci in tutti i passaggi.

Il nodo finale in JSONPath è il nome della variabile di destinazione, ad esempio. instanceId

Ogni passaggio può fare riferimento all'output di qualsiasi azione precedente con queste variabili dinamiche JSONPath. Questo è anche noto come concatenamento o riferimento. Per fare riferimento all'output di un'azione precedente, è possibile utilizzare la seguente variabile dinamica.

$.stepOutputs.step-name.output-name

Esempio 1: indicatore di concatenamento dei parametri di input

L'esempio seguente mostra un parametro di input che utilizza l'interpolazione di stringhe per risolvere una variabile dinamica nel valore del parametro in fase di esecuzione.

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

Esempio 2: interpolazione di stringhe in variabili dinamiche

L'esempio seguente dimostra come le variabili dinamiche utilizzano l'interpolazione di stringhe per determinare i valori in fase di esecuzione.

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

In questo esempio, le espressioni JSONPath racchiuse tra doppie parentesi graffe vengono risolte in fase di esecuzione:

Le stringhe letterali like rimangono invariate. "region": "us-east-1"

Usa le variabili di sistema di Image Builder

Image Builder fornisce le seguenti variabili di sistema che è possibile utilizzare nel documento del flusso di lavoro. Si tratta di valori di sola lettura che Image Builder compila in fase di esecuzione. Ad esempio, si fa riferimento a una variabile di sistema con il nodo della struttura del imagebuilder documento. $.imagebuilder.platform