Batch 量生成構建規範參考

本主題包含批處理構建屬性的構建規範參考。

批次

選用的映射。項目的批量生成設置。

批次/快速失敗

選用。指定一個或多個生成任務失敗時批處理生成的行為。

false

預設值。所有正在運行的構建都將完成。

true

當其中一個構建任務失敗時，所有正在運行的構建都將停止。

默認情況下，所有批處理構建任務都使用生成設置（如env和phases（在 Buildspec 檔案中指定）。您可以通過指定不同的env值或不同的構建規範文件batch/<batch-type>/buildspec參數。

的內容batch屬性會因指定的批次構建類型而異。可能的批處理構建類型有：

• batch/build-graph

• batch/build-list

• batch/build-matrix

batch/build-graph

定義建置圖表。生成圖形定義了一組與批處理中的其他任務具有依賴關係的任務。如需詳細資訊，請參閱 構建圖。

此元素包含一系列的建置任務。每個生成任務都包含下列屬性。

標識符

必要。任務的識別符。

BuildSpec

選用。用於此任務的 Buildspec 檔案的路徑和名稱。如果未指定此參數，將使用當前 Buildspec 檔案。

偵錯會話

選用。布林值類型，用以指示是否啟用此批次生成的會話偵錯。如需工作階段調試的詳細資訊，請參在工作階段管理員中檢視正在執行。

false

會話調試已禁用。

true

會話調試已啟用。

依

選用。此任務所依賴的任務標識符數組。在完成這些任務之前，此任務將不會運行。

env

選用。任務的構建環境將覆蓋。此程式碼可包含下列屬性：

運算類型

用於任務的計算類型的標識符。請參閱computeType在建置環境運算模式和類型以獲取可能的值。

映像

用於任務的映像識別符。請參閱映像識別符在碼頭圖片提供 CodeBuild以獲取可能的值。

特權模式

布林值類型，用以指示是否在 Docker 容器中執行 Docker 協助程式。設定為true只有使用 Builker 項目來建置 Docker 映像時。否則，嘗試與 Docker 協助程式互動的組建會失敗。預設設定為 false。

類型

用於任務的環境類型的標識符。請參閱環境類型在建置環境運算模式和類型以獲取可能的值。

變數

構建環境中將出現的環境變量。如需詳細資訊，請參閱 env/variables。

忽略失敗

選用。一個布爾值，指示是否可以忽略此構建任務的失敗。

false

預設值。如果此生成任務失敗，批處理構建將失敗。

true

如果此生成任務失敗，批處理構建仍然可以成功。

以下是建置圖形 Buildspec 項目範例：

batch:
  fast-fail: false
  build-graph:
    - identifier: build1
      env:
        variables:
          BUILD_ID: build1
      ignore-failure: false
    - identifier: build2
      buildspec: build2.yml
      env:
        variables:
          BUILD_ID: build2
      depend-on:
        - build1
    - identifier: build3
      env:
        variables:
          BUILD_ID: build3
      depend-on:
        - build2

batch/build-list

定義構建列表。構建列表用於定義多個並行運行的任務。如需詳細資訊，請參閱 組建清單。

此元素包含一系列的建置任務。每個生成任務都包含下列屬性。

標識符

必要。任務的識別符。

BuildSpec

選用。用於此任務的 Buildspec 檔案的路徑和名稱。如果未指定此參數，將使用當前 Buildspec 檔案。

偵錯會話

選用。布林值類型，用以指示是否啟用此批次生成的會話偵錯。如需工作階段調試的詳細資訊，請參在工作階段管理員中檢視正在執行。

false

會話調試已禁用。

true

會話調試已啟用。

env

選用。任務的構建環境將覆蓋。此程式碼可包含下列屬性：

運算類型

用於任務的計算類型的標識符。請參閱computeType在建置環境運算模式和類型以獲取可能的值。

映像

用於任務的映像識別符。請參閱映像識別符在碼頭圖片提供 CodeBuild以獲取可能的值。

特權模式

布林值類型，用以指示是否在 Docker 容器中執行 Docker 協助程式。設定為true只有使用 Builker 項目來建置 Docker 映像時。否則，嘗試與 Docker 協助程式互動的組建會失敗。預設設定為 false。

類型

用於任務的環境類型的標識符。請參閱環境類型在建置環境運算模式和類型以獲取可能的值。

變數

構建環境中將出現的環境變量。如需詳細資訊，請參閱 env/variables。

忽略失敗

選用。一個布爾值，指示是否可以忽略此構建任務的失敗。

false

預設值。如果此生成任務失敗，批處理構建將失敗。

true

如果此生成任務失敗，批處理構建仍然可以成功。

以下是建置列表 Buildspec 項目範例：

batch:
  fast-fail: false
  build-list:
    - identifier: build1
      env:
        variables:
          BUILD_ID: build1
      ignore-failure: false
    - identifier: build2
      buildspec: build2.yml
      env:
        variables:
          BUILD_ID: build2
      ignore-failure: true

batch/build-matrix

定義建置矩陣。構建矩陣定義了具有並行運行的不同配置的任務。CodeBuild 為每個可能的配置組合創建一個單獨的構建。如需詳細資訊，請參閱 建立矩陣。

靜態的

靜態屬性適用於所有構建任務。

忽略失敗

選用。一個布爾值，指示是否可以忽略此構建任務的失敗。

false

預設值。如果此生成任務失敗，批處理構建將失敗。

true

如果此生成任務失敗，批處理構建仍然可以成功。

env

選用。構建環境將覆蓋所有任務。

特權模式

布林值類型，用以指示是否在 Docker 容器中執行 Docker 協助程式。設定為true只有使用 Builker 項目來建置 Docker 映像時。否則，嘗試與 Docker 協助程式互動的組建會失敗。預設設定為 false。

類型

用於任務的環境類型的標識符。請參閱環境類型在建置環境運算模式和類型以獲取可能的值。

動態

動態屬性定義構建矩陣。

BuildSpec

選用。一個數組，其中包含要用於這些任務的 buildspec 文件的路徑和文件名。如果未指定此參數，將使用當前 Buildspec 檔案。

env

選用。這些任務的構建環境將覆蓋。

運算類型

一個數組，其中包含要用於這些任務的計算類型的標識符。請參閱computeType在建置環境運算模式和類型以獲取可能的值。

映像

包含用於這些任務的圖像標識符的數組。請參閱映像識別符在碼頭圖片提供 CodeBuild以獲取可能的值。

變數

一個數組，其中包含將出現在這些任務的構建環境中的環境變量。如需詳細資訊，請參閱 env/variables。

以下是建置矩陣 Buildspec 項目範例：

batch:
  build-matrix:
    static:
      ignore-failure: false
    dynamic:
      buildspec: 
        - matrix1.yml
        - matrix2.yml
      env:
        variables:
          MY_VAR:
            - VALUE1
            - VALUE2
            - VALUE3

如需詳細資訊，請參閱建立矩陣。