在工作流程文件中使用動態變數

您可以使用工作流程文件中的動態變數來表示影像建立程序在執行時間變化的值。動態變數的字串插補可讓您在 JSON 字串等結構化內容中嵌入 JSONPath 表達式。當您需要在複雜的承載中將執行時間值傳遞至 ExecuteStateMachine或 等步驟動作時，此功能特別有用WaitForAction。

若要對動態變數使用字串插補，請在字串內容"{{...}}"中以雙大括號包裝 JSONPath 運算式。只有以雙大括號包裝的 JSONPath 表達式才會處理為變數。任何未包裝在雙大括號中的 JSONPath 表達式都會視為常值字串內容。

JSONPath 動態工作流程變數語法

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

動態變數值以 JSONPath 選擇器表示，具有可唯一識別目標變數的結構節點。根目錄 ($) 之後的第一個節點是指工作流程文件結構，例如 stepOutputs，若為 Image Builder 系統變數，則為 imageBuilder。下列清單包含支援的 JSONPath 工作流程文件結構節點。

parameters 和 stepOutputs 文件結構節點包含步驟名稱的選用節點。這有助於確保所有步驟的唯一變數名稱。

JSONPath 中的最後一個節點是目標變數的名稱，例如 instanceId。

每個步驟都可以使用這些 JSONPath 動態變數來參考任何先前步驟動作的輸出。這也稱為鏈結或參考。若要參考先前步驟動作的輸出，您可以使用下列動態變數。

$.stepOutputs.step-name.output-name

範例 1：輸入參數鏈結指標

下列範例顯示輸入參數，其使用字串插補在執行時間解析參數值中的動態變數。

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

範例 2：動態變數中的字串插補

下列範例示範動態變數如何使用字串插補來判斷執行時間的值。

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

在此範例中，以雙大括號包裝的 JSONPath 表達式會在執行時間解析：

像 的文字字串"region": "us-east-1"保持不變。

使用映像建置器系統變數

Image Builder 提供下列系統變數，您可以在工作流程文件中使用：