執行批次建置 (AWS CLI)

1. 使用下列其中一種方式，執行 start-build-batch 命令：

   aws codebuild start-build-batch --project-name <project-name>

   如果您想要執行的建置使用建置輸入成品和組建專案現有設定的最新版本，則請使用此命令。

   aws codebuild start-build-batch --generate-cli-skeleton > <json-file>

   如果您想要執行的建置使用建置輸入成品的舊版本，或者想要覆寫建置輸出成品、環境變數、buildspec 或預設建置逾時期間的設定，則請使用此命令。

2. 如果您搭配執行start-build-batch命令與--project-name選項，替換<project-name>與組建專案的名稱，然後跳到本程序的步驟 6。若要取得組建專案清單，請參閱檢視建置專案名稱清單。

3. 如果您搭配執行start-build-batch命令與--idempotency-token選項，則會隨附唯一區分大小寫識別符或字符。start-build-batch請求。此字符在 請求之後的 5 分鐘內有效。如果重複start-build-batch請求，但變更參數，則 CodeBuild 會返回參數不符錯誤。

4. 如果您搭配執行start-build-batch命令與--generate-cli-skeleton選項時，JSON 格式的數據將輸出到<json-file>file. 此檔案與start-build命令，並添加以下對象。如需公共物件的詳細資訊，請參執行建置 (AWS CLI)。

   修改此檔案以添加任何建置覆蓋，並儲存您的結果。

     "buildBatchConfigOverride": {
       "combineArtifacts": combineArtifacts,
       "restrictions": {
         "computeTypesAllowed": [
           allowedComputeTypes
         ],
         "maximumBuildsAllowed": maximumBuildsAllowed
       },
       "serviceRole": "batchServiceRole",
       "timeoutInMins": batchTimeout
     }

   所以此buildBatchConfigOverride物件是ProjectBuildBatchConfig結構，該結構包含此版本的批處理構建配置覆蓋。

   組合成品

   布爾值，指定批次建置的建置成品是否應合併成單一成品位置。

   允許的計算機類型

   字串陣列，指定批次建置允許的運算類型。請參閱建置環境運算類型對於這些值。

   最大建置成品

   指定允許的建置數目上限。

   批量服務

   指定批次建置專案的服務角色 ARN。

   批處理超時

   指定批次建置必須完成的時間上限 (以分鐘為單位)。

5. 切換到包含您剛儲存之檔案的目錄，然後再次執行 start-build-batch 命令。

   aws codebuild start-build-batch --cli-input-json file://start-build.json

6. 如果成功，則構建批處理物件會顯示於主控台輸出。請參。啟動建置批次回應語法查看此數據的示例。