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-Zeichenfolgen 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, schließen Sie JSONPath-Ausdrücke innerhalb Ihres Zeichenketteninhalts in doppelte geschweifte Klammern ein. "{{...}}" 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 literaler Zeichenfolgeninhalt behandelt.

Syntax der dynamischen Workflow-Variablen von JSONPath

$.<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-Systemvariablen,. imageBuilder Die folgende Liste enthält unterstützte JSONPath-Workflow-Dokumentstrukturknoten.

Die Knoten parameters und die stepOutputs Dokumentstrukturknoten enthalten einen optionalen Knoten für den Schrittnamen. Auf diese Weise wird sichergestellt, dass in allen Schritten eindeutige Variablennamen gelten.

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

Jeder Schritt kann mit diesen dynamischen JSONPath-Variablen auf die Ausgabe aller Aktionen früherer Schritte verweisen. 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 zur Laufzeit mithilfe von Zeichenketteninterpolation eine dynamische Variable im Parameterwert auflöst.

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

Beispiel 2: Zeichenketteninterpolation in dynamischen Variablen

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

- 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 JSONPath-Ausdrücke, die in doppelte geschweifte Klammern eingeschlossen sind, zur Laufzeit aufgelöst:

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

Verwenden Sie Image 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