Verwenden Sie dynamische Variablen in Ihrem Workflow-Dokument

Sie können dynamische Variablen in Ihren Workflow-Dokumenten verwenden, um Werte darzustellen, die zur Laufzeit Ihres Image-Erstellungsprozesses variieren. Die Zeichenketteninterpolation für dynamische Variablen ermöglicht es Ihnen, JSONPath-Ausdrücke in strukturierte Inhalte wie JSON-Zeichenketten einzubetten. Dies ist besonders nützlich, wenn Sie Laufzeitwerte innerhalb komplexer Nutzlasten an Schrittaktionen wie oder übergeben müssen. ExecuteStateMachine WaitForAction

Um die Zeichenketteninterpolation für dynamische Variablen zu verwenden, setzen Sie JSONPath-Ausdrücke innerhalb Ihres Zeichenketteninhalts in doppelte geschweifte Klammern. "{{...}}" Nur JSONPath-Ausdrücke, die in doppelte geschweifte Klammern eingeschlossen sind, werden als Variablen verarbeitet. Alle JSONPath-Ausdrücke, die nicht in doppelte geschweifte Klammern eingeschlossen sind, werden als wörtliche Zeichenketteninhalte behandelt.

Syntax der dynamischen JSONPath-Workflow-Variablen

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

Dynamische Variablenwerte werden als JSONPath-Selektoren mit Strukturknoten dargestellt, die die Zielvariable eindeutig identifizieren. Der erste Knoten nach dem Stamm ($) bezieht sich auf die Workflow-Dokumentstruktur, z. B. oderstepOutputs, im Fall von Image Builder Builder-Systemvariablen,imageBuilder. Die folgende Liste enthält unterstützte JSONPath-Workflow-Dokumentstrukturknoten.

Die Knoten parameters und die stepOutputs Dokumentstruktur enthalten einen optionalen Knoten für den Schrittnamen. Dadurch wird sichergestellt, dass in allen Schritten eindeutige Variablennamen verwendet werden.

Der letzte Knoten im JSONPath ist der Name der Zielvariablen, z. B. instanceId

Jeder Schritt kann sich auf die Ausgabe aller Aktionen eines vorherigen Schritts mit diesen dynamischen JSONPath-Variablen beziehen. Dies wird auch als Verkettung oder Referenzierung bezeichnet. Um auf die Ausgabe einer Aktion aus einem vorherigen Schritt zu verweisen, können Sie die folgende dynamische Variable verwenden.

$.stepOutputs.step-name.output-name

Beispiel 1: Indikator für die Verkettung von Eingabeparametern

Das folgende Beispiel zeigt einen Eingabeparameter, der Zeichenketteninterpolation verwendet, um zur Laufzeit eine dynamische Variable im Parameterwert aufzulösen.

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

Beispiel 2: Zeichenketteninterpolation in dynamischen Variablen

Das folgende Beispiel zeigt, wie dynamische Variablen Zeichenketteninterpolation verwenden, um Werte zur Laufzeit zu bestimmen.

- 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 diesem Beispiel werden die in doppelten geschweiften Klammern eingeschlossenen JSONPath-Ausdrücke zur Laufzeit aufgelöst:

Die literalen Zeichenketten wie "region": "us-east-1" bleiben unverändert.

Verwenden Sie Image Builder Builder-Systemvariablen

Image Builder stellt die folgenden Systemvariablen bereit, die Sie in Ihrem Workflow-Dokument verwenden können. Dies sind schreibgeschützte Werte, die Image Builder zur Laufzeit auffüllt. Sie verweisen beispielsweise mit dem imagebuilder Dokumentstrukturknoten auf eine Systemvariable. $.imagebuilder.platform