Menggunakan variabel dinamis dalam dokumen alur kerja Anda

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

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

sintaks variabel alur kerja dinamis JSONPath

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

Nilai variabel dinamis direpresentasikan sebagai pemilih JSONPath 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 Pembuat Gambar,imageBuilder. Daftar berikut berisi node struktur dokumen alur kerja JSONPath yang didukung.

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

Node terakhir di JSONPath adalah nama variabel target, seperti. instanceId

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

$.stepOutputs.step-name.output-name

Contoh 1: Indikator rantai parameter input

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 pada 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, ekspresi JSONPath yang dibungkus dengan kurung kurung keriting ganda diselesaikan saat runtime:

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

Gunakan variabel sistem Pembuat Gambar

Image Builder menyediakan variabel sistem berikut yang dapat Anda gunakan dalam dokumen alur kerja Anda. Ini adalah nilai read-only yang diisi Image Builder saat runtime. Anda mereferensikan variabel sistem dengan simpul struktur imagebuilder dokumen, misalnya$.imagebuilder.platform.