CodeBuild 的建置規格參考

選用的映射。用於指示 CodeBuild 是否使用其 Git 登入資料協助程式來提供 Git 登入資料。 yes 如果使用的話。否則為 no 或未指定。如需詳細資訊，請參閱 Git 網站上的 gitcredentials 。

選用的序列。在建置階段中用來指定可執行其命令的 Linux 使用者。如果也在 buildspec 檔案上方為所有命令全域指定 run-as ，則階段層級的使用者具有優先權。例如，如果全域 run-as 指定 User-1，而對於 install 階段，只有 run-as 陳述式指定 User-2，則 中的所有命令會以 User-1 執行， 但 install 階段中的命令除外，這些命令會以 User-2 執行。

選用的序列。指定在階段期間發生失敗時要採取的動作。這可以是下列其中一個值：

RETRY - 重試組建最多 3 次，並顯示符合規則表達式 的錯誤訊息 .* 。

RETRY- count - 以符合規則表達式 的錯誤訊息 計數 表示，在指定的次數內重試組建 .* 。請注意， 計數 必須介於 0 到 100 之間。例如，有效值包括 RETRY-4 和 RETRY-8 。

RETRY- regex - 重試建置最多 3 次，並使用 regex 包含規則運算式以符合指定的錯誤訊息。例如，有效值包括 Retry-.*Error: Unable to connect to database.* 和 RETRY-invalid+ 。

RETRY- count - regex - 在指定的次數內重試組建，如 計數 所示。請注意， 計數 必須介於 0 到 100 之間。您也可以使用 regex 來包含規則表達式，以符合錯誤訊息。例如，有效值包括 Retry-3-.*connection timed out.* 和 RETRY-8-invalid+ 。

如果未指定此屬性，則失敗程序會遵循轉換階段，如 所示 建置階段轉換 。

選用的區塊。 finally 區塊中指定的命令會在 commands 區塊中的命令之後執行。即使 finally 區塊中的命令失敗，也會執行 commands 區塊中的命令。例如，如果 commands 區塊包含三個命令且第一個失敗，CodeBuild 會略過剩餘的兩個命令，並在 finally 區塊中執行任何命令。當 commands 和 finally 區塊中的所有命令成功執行時，此階段即成功。如果階段中的任何命令失敗，階段即失敗。

允許的建置階段名稱為：

選用的序列。Ubuntu 標準映像 5.0 或更新版本和 Amazon Linux 2 標準映像 4.0 或更新版本支援執行期版本。如已指定，此區段中至少要包含一個執行時間。使用特定版本指定執行時間，主要版本後面接著 ， .x 以指定 CodeBuild 使用該主要版本搭配其最新的次要版本，或使用 latest 最新的主要和次要版本 （例如 ruby: 3.2 、 nodejs: 18.x 或 java: latest )。您可以使用數字或環境變數指定執行時間。例如，如果您使用 Amazon Linux 2 標準映像 4.0，則以下指定已安裝 Java 版本 17、python 版本 3 的最新次要版本，以及 Ruby 環境變數中包含的版本。如需詳細資訊，請參閱 CodeBuild 提供的 Docker 映像 。

phases:
  install:
    runtime-versions:
      java: corretto8
      python: 3.x
      ruby: "$MY_RUBY_VAR"

您可以在 buildspec 檔案的 runtime-versions 區段中指定一或多個執行時間。如果您的執行階段依存於另一個執行時間，您也可以在 buildspec 檔案中指定其相依的執行時間。如果您未在 buildspec 檔案中指定任何執行時間，CodeBuild 會選擇您所使用的映像中可用的預設執行時間。如果您指定一或多個執行時間，CodeBuild 只會使用這些執行時間。如果未指定相依執行時間，CodeBuild 會嘗試為您選擇相依執行時間。

如果兩個指定的執行時間發生衝突，則建置會失敗。例如， android: 29 和 java: openjdk11 相衝突，所以如果指定這兩個，則組建會失敗。

如需可用執行時間的詳細資訊，請參閱 可用的執行時間 。

選用的序列。指定傳送報告的目標報告群組。一個專案最多可以擁有五個報告群組。指定現有報告群組的 ARN，或新報告群組的名稱。如果您指定名稱，CodeBuild 會使用專案名稱和您以 格式指定的名稱來建立報告群組 <project-name>-<report-group-name> 。您也可以使用 buildspec 中的環境變數來設定報告群組名稱，例如 $REPORT_GROUP_NAME 。如需詳細資訊，請參閱 報告群組命名 。

必要的序列。代表包含由建立產生之測試結果原始資料的位置。包含一系列純量，每個純量代表 CodeBuild 可以尋找測試檔案的個別位置，相對於原始建置位置，或者，如果設定，則為 base-directory 。位置可能包括下列：

單一檔案 (例如， my-test-report-file.json )。

子目錄中的單一檔案 (例如， my-subdirectory /my-test-report-file.json 或 my-parent-subdirectory / my-subdirectory /my-test-report-file.json )。

'**/*' 代表遞迴的所有檔案。

my-subdirectory /* 代表名為 my-subdirectory 的子目錄中的所有檔案。

my-subdirectory /**/* 代表從名為 my-subdirectory 開始的子目錄遞迴的所有檔案。

選用的映射。代表報告檔案格式。如果未指定，則會使用 JUNITXML 。此值不區分大小寫。可能值為：

選用的映射。代表一個或多個最上層目錄，相對於原始建置位置，CodeBuild 用來判斷在何處尋找原始測試檔案。

選用。指定報告檔案目錄是否在輸出中平面化。如果未指定或包含 no ，則報告檔案會以完整的目錄結構輸出。如果包含 yes ，則所有的測試檔案都會放置在相同的輸出目錄中。例如，如果測試結果的路徑是 com/myapp/mytests/TestResult.xml ，則指定 yes 會將此檔案置於 /TestResult.xml 中。

選用的序列。代表 CodeBuild 尋找建置輸出的位置，以及 CodeBuild 如何準備上傳到 S3 輸出儲存貯體的相關資訊。例如，如果您正在建置 Docker 映像並將其推送至 Amazon ECR，或者正在對原始程式碼執行單元測試，但未建置它，則不需要此序列。

單一檔案 (例如， my-file.jar )。

子目錄中的單一檔案 (例如， my-subdirectory /my-file.jar 或 my-parent-subdirectory / my-subdirectory /my-file.jar )。

'**/*' 代表遞迴的所有檔案。

my-subdirectory /* 代表名為 my-subdirectory 的子目錄中的所有檔案。

my-subdirectory /**/* 代表從名為 my-subdirectory 開始的子目錄遞迴的所有檔案。

當您指定組建輸出成品位置時，CodeBuild 可以在組建環境中找到原始組建位置。您不需要在組建成品輸出位置前方附加原始組建位置的路徑或指定 ./ 之類內容。如果要知道此位置的路徑，您可以在組建期間執行 echo $CODEBUILD_SRC_DIR 之類命令。每個組建環境的位置可能稍有不同。

選用名稱。指定組建成品的名稱。當下列其中一項成立時，會使用此名稱。

您可以使用 CodeBuild API 來建立組建，並在更新專案、建立專案或啟動組建時，在 ProjectArtifacts 物件上設定 overrideArtifactName 旗標。

您可以使用 CodeBuild 主控台來建立組建、在 buildspec 檔案中指定名稱，並在建立或更新專案時選取 啟用語意版本控制 。如需詳細資訊，請參閱 建立組建專案 (主控台) 。

您可以在組建時計算的組建規格檔案中指定名稱。組建規格檔案中指定的名稱使用 Shell 命令語言。例如，您可以將日期和時間附加到成品名稱，讓它一律是唯一的。唯一成品名稱可防止覆寫成品。如需詳細資訊，請參閱 Shell 命令語言 。