執行批次建置 (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. 如果您使用 --project-name選項執行 start-build-batch命令，請將 <project-name> 取代為建置專案的名稱，然後跳至此程序的步驟 6。若要取得組建專案清單，請參閱檢視組建專案名稱。

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

4. 如果您使用 --generate-cli-skeleton選項執行 start-build-batch命令，JSON 格式的資料會輸出到 <json-file> 檔案。此檔案類似於 start-build命令產生的骨架，並新增下列物件。如需常見物件的詳細資訊，請參閱 執行建置 (AWS CLI)。

   修改此檔案以新增任何組建覆寫，並儲存結果。

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

   buildBatchConfigOverride 物件是 ProjectBuildBatchConfig 結構，其中包含此建置的批次建置組態覆寫。

   combineArtifacts

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

   allowedComputeTypes

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

   maximumBuildsAllowed

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

   batchServiceRole

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

   batchTimeout

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

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

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

6. 如果成功，則 BuildBatch 物件的 JSON 表示法會出現在主控台輸出中。如需此資料的範例，請參閱 StartBuildBatch 回應語法。