在工作流程文件中使用動態變數 - EC2Image Builder
使用 Image Builder 系統變數

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

您可以在工作流程文件中使用動態變數，來代表影像建立程序在執行階段不同的值。動態變數值會表示為具有唯一識別目標變數之結構節點的JSONPath選取器。

JSONPath動態工作流變數結構

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

根 ($) 之後的第一個節點是指工作流程文件結構，例如stepOutputs，或在 Image Builder 系統變數的情況下，imageBuilder。下列清單包含支援的JSONPath工作流程文件結構節點。

文件結構節點

  • 參數-工作流程參數

  • stepOutputs -相同工作流程文件中某個步驟的輸出

  • workflowOutputs -來自已執行的工作流程文件的輸出

  • Image Builder-圖像生成器系統變量

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

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

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

$.stepOutputs.step-name.output-name

範例

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

使用 Image Builder 系統變數

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

變數名稱

Description (描述)

Type

範例值

cloudWatchLog集團

輸出 CloudWatch 記錄檔的「記錄」群組名稱。

格式：/aws/imagebuilder/<recipe-name>

字串

/aws/imagebuilder/sampleImageRecipe

cloudWatchLog串流

輸出 CloudWatch 記錄檔的記錄資料流名稱。

字串

1.0.0/1

collectImageMetadata

指示 Image Builder 是否收集執行個體中繼資料的設定。

Boolean

true | false

collectImageScan發現

可讓映像產生器收集影像掃描發現項目的設定目前值。

Boolean

true | false

imageBuildNumber

映像檔的組建版本號碼。

Integer

1

imageId

基本映像檔的AMI識別碼。

字串

ami-1234567890abcdef1

imageName

影像的名稱。

字串

sampleImage

imageType

影像輸出類型。

字串

AMI | Docker

imageVersionNumber

影像的版本號碼。

字串

1.0.0

instanceProfileName

Image Builder 用來啟動組建和測試執行個體的執行個體設定檔角色名稱。

字串

SampleImageBuilderInstanceProfileRole

平台

所建置映像檔的作業系統平台。

字串

Linux | Windows | MacOS

記錄

包JSON含 Image Builder 所寫入之 S3 日誌組態的物件。

JSON物件

{'S3 日誌': {'s3 'BucketName:'sample-bucket',' 三 KeyPrefix ':'ib-logs'}}

securityGroups

套用至建置和測試執行個體的安全性群組IDs。

列表 [字符串]

[sg-1234567890abcdef1, sg-11112222333344445]

sourceImageARN

工作流程用於建置和測試階段的映 Image Builder 映像資源的 Amazon 資源名稱 (ARN)。

字串

AR: aws: 影像建置器:us-east-1:111122223333：圖片/sampleImage/1.0.0/1

subnetId

要啟動組建和測試執行個體的子網路識別碼。

字串

subnet-1234567890abcdef1

terminateInstanceOn失敗

設定的目前值，指示 Image Builder 在發生故障時終止執行個體，或保留執行個體以進行疑難排解。

Boolean

true | false

workflowPhase

為工作流程執行所執行的目前階段。

字串

Build | Test

workingDirectory

工作目錄的路徑。

字串

/tmp