執行建置 (AWS CLI)

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

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

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

aws codebuild start-build --generate-cli-skeleton

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

如果您執行start-build使用指令--project-name選項，取代<project-name>使用建置專案的名稱，然後跳至此程序的步驟 6。若要取得組建專案清單，請參閱檢視建置專案名稱。

如果您執行start-build使用指令--idempotency-tokenoption (區分大小寫的唯一識別碼或權杖) 包含在start-build請求。此字符在 請求之後的 5 分鐘內有效。如果您使用相同的字符來重複 start-build 請求，但變更參數，則 CodeBuild 會傳回參數不符錯誤。

如果您搭配執行 start-build 命令與 --generate-cli-skeleton 選項，則會在輸出中顯示 JSON 格式化資料。將資料複製至本機電腦或執行個體上 AWS CLI 安裝位置中的檔案 (例如，start-build.json)。修改複製的資料以符合下列格式，並儲存您的結果：

{
  "projectName": "projectName",
  "sourceVersion": "sourceVersion",
  "artifactsOverride": {
    "type": "type",
    "location": "location",
    "path": "path",
    "namespaceType": "namespaceType",
    "name": "artifactsOverride-name",
    "packaging": "packaging"
  },
  "buildspecOverride": "buildspecOverride",
  "cacheOverride": {
    "location": "cacheOverride-location",
    "type": "cacheOverride-type"
  },
  "certificateOverride": "certificateOverride",
  "computeTypeOverride": "computeTypeOverride",
  "environmentTypeOverride": "environmentTypeOverride",
  "environmentVariablesOverride": {
    "name": "environmentVariablesOverride-name",
    "value": "environmentVariablesValue",
    "type": "environmentVariablesOverride-type"
  },
  "gitCloneDepthOverride": "gitCloneDepthOverride",
  "imageOverride": "imageOverride",
  "idempotencyToken": "idempotencyToken",
  "insecureSslOverride": "insecureSslOverride",
  "privilegedModeOverride": "privilegedModeOverride",
  "queuedTimeoutInMinutesOverride": "queuedTimeoutInMinutesOverride",
  "reportBuildStatusOverride": "reportBuildStatusOverride",
  "timeoutInMinutesOverride": "timeoutInMinutesOverride",
  "sourceAuthOverride": "sourceAuthOverride",
  "sourceLocationOverride": "sourceLocationOverride",
  "serviceRoleOverride": "serviceRoleOverride",
  "sourceTypeOverride": "sourceTypeOverride"
}

取代下列預留位置：

我們建議您儲存具有敏感值的環境變數，例如AWS存取金鑰識別碼，一個AWS秘密存取金鑰或密碼做為 Amazon EC2 系統管理員參數存放區中的參數。CodeBuild只有在參數名稱開頭為時，才能使用存放在 Amazon EC2 系統管理員參數存放區中的參數/CodeBuild/（例如，/CodeBuild/dockerLoginPassword). 您可以使用CodeBuild在亞馬遜 EC2 系統管理器中創建參數的控制台。選擇 Create a parameter (建立參數)，然後遵循指示進行。(在該對話方塊中，用於KMS 金鑰，您可以選擇性地指定的 ARNAWS KMS輸入您的帳戶。 Amazon EC2 系統管理員使用此金鑰在儲存期間加密參數的值，並在擷取期間進行解密。) 如果您使用 CodeBuild 主控台建立參數，則主控台會使用存放的 /CodeBuild/ 來啟動參數。但是，如果您使用 Amazon EC2 系統管理員參數存放區主控台建立參數，則必須以/CodeBuild/，且您必須設定类型至安全字串。如需詳細資訊，請參閱〈AWS Systems Manager參數存放區和逐步解說：建立和測試 String 參數 (主控台)在亞馬遜 EC2 系統管理器用戶指南。

如果您的建置專案參考存放在 Amazon EC2 系統管理員參數存放區中的參數，則建置專案的服務角色必須允許ssm:GetParameters動作。如果您稍早選擇 Create a new service role in your account (在帳戶中建立新的服務角色)，則 CodeBuild 會將此動作自動包含在您建置專案的預設服務角色中。不過，如果您選擇 Choose an existing service role from your account (從您的帳戶中選擇現有服務角色)，則必須將此動作單獨包含在服務角色中。

您設定的環境變數會取代現有環境變數。例如，如果 Docker 影像已包含名為 MY_VAR 且值為 my_value 的環境變數，而且您設定名為 MY_VAR 且值為 other_value 的環境變數，則 my_value 會取代為 other_value。同樣地，如果 Docker 影像已包含名為 PATH 且值為 /usr/local/sbin:/usr/local/bin 的環境變數，而且您設定名為 PATH 且值為 $PATH:/usr/share/ant/bin 的環境變數，則 /usr/local/sbin:/usr/local/bin 會取代為文字值 $PATH:/usr/share/ant/bin。

請不要設定名稱開頭為 CODEBUILD_ 的任何環境變數。此字首保留供 內部使用。

如果有多個位置定義同名的環境變數，則會決定環境變數的值，如下所示：

如需這些預留位置有效值的資訊，請參閱建立建置專案 (AWS CLI)。如需組建專案的最新設定清單，請參閱檢視建置專案詳細資訊。

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

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

如果成功，則會在輸出中顯示執行建置 程序中所述資料類似的資料。