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 di stringhe per variabili dinamiche consente di incorporare espressioni JSONPath all'interno di contenuti strutturati come stringhe JSON. Ciò è particolarmente utile quando è necessario passare valori di runtime all'interno di payload complessi per eseguire azioni come o. ExecuteStateMachine WaitForAction

Per utilizzare l'interpolazione di stringhe per variabili dinamiche, racchiudi le espressioni JsonPath tra parentesi graffe doppie 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 parentesi graffe doppie vengono trattate come contenuto di stringhe letterali.

Sintassi dinamica delle variabili del flusso di lavoro 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 parameters nodi della struttura stepOutputs del documento includono un nodo opzionale per il nome del passaggio. Questo aiuta a garantire nomi di variabili univoci in tutti i passaggi.

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

Ogni passaggio può fare riferimento all'output di qualsiasi azione del passaggio precedente con queste variabili dinamiche JsonPath. Questa operazione è nota anche 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 parentesi graffe doppie vengono risolte in fase di esecuzione:

Le stringhe letterali, ad esempio, 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