Gunakan variabel dinamis dalam dokumen alur kerja Anda

Anda dapat menggunakan variabel dinamis dalam dokumen alur kerja Anda untuk mewakili nilai yang bervariasi saat runtime untuk proses pembuatan gambar Anda. Interpolasi string untuk variabel dinamis memungkinkan Anda untuk menyematkan JSONPath ekspresi dalam konten terstruktur seperti string JSON.Ini sangat berguna ketika Anda perlu meneruskan nilai runtime dalam muatan kompleks ke tindakan langkah seperti atau. ExecuteStateMachine WaitForAction

Untuk menggunakan interpolasi string untuk variabel dinamis, bungkus JSONPath ekspresi dalam kurung kurawal ganda "{{...}}" dalam konten string Anda. Hanya JSONPath ekspresi yang dibungkus dalam kurung kurawal ganda yang diproses sebagai variabel. JSONPath Ekspresi apa pun yang tidak dibungkus dalam kurung kurawal ganda diperlakukan sebagai konten string literal.

JSONPath sintaks variabel alur kerja dinamis

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

Nilai variabel dinamis direpresentasikan sebagai JSONPath pemilih dengan node struktural yang secara unik mengidentifikasi variabel target. Node pertama setelah root ($) mengacu pada struktur dokumen alur kerja, sepertistepOutputs, atau dalam kasus variabel sistem Image Builder,imageBuilder. Daftar berikut berisi node struktur dokumen JSONPath alur kerja yang didukung.

Node struktur parameters dan stepOutputs dokumen menyertakan node opsional untuk nama langkah. Ini membantu memastikan nama variabel unik di semua langkah.

Node terakhir dalam JSONPath adalah nama variabel target, sepertiinstanceId.

Setiap langkah dapat merujuk ke output dari setiap tindakan langkah sebelumnya dengan variabel JSONPath dinamis ini. Ini juga dikenal sebagai rantai, atau referensi. Untuk merujuk ke output dari tindakan langkah sebelumnya, Anda dapat menggunakan variabel dinamis berikut.

$.stepOutputs.step-name.output-name

Contoh 1: Indikator rantai parameter masukan

Contoh berikut menunjukkan parameter input yang menggunakan interpolasi string untuk menyelesaikan variabel dinamis dalam nilai parameter saat runtime.

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

Contoh 2: Interpolasi string dalam variabel dinamis

Contoh berikut menunjukkan bagaimana variabel dinamis menggunakan interpolasi string untuk menentukan nilai saat runtime.

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

Dalam contoh ini, JSONPath ekspresi yang dibungkus dengan tanda kurung kurawal ganda diselesaikan saat runtime:

String literal seperti "region": "us-east-1" tetap tidak berubah.

Gunakan variabel sistem Image Builder

Image Builder menyediakan variabel sistem berikut yang dapat Anda gunakan dalam dokumen alur kerja Anda: