本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 中自動重試建置 AWS CodeBuild
<a name="auto-retry-build"></a>

您可以使用 AWS CodeBuild 主控台 AWS CLI或 AWS SDKs 自動重試您的建置 AWS CodeBuild。啟用自動重試後，CodeBuild 會在失敗的建置達到指定的限制後`RetryBuild`，使用專案的服務角色自動呼叫 。例如，如果自動重試限制設為 2，CodeBuild 將呼叫 `RetryBuild` API 以自動重試您的組建最多兩次。

**注意**  
CodeBuild 不支援 CodePipeline 的自動重試。

**Topics**
+ [自動重試組建 （主控台）](#auto-retry-build-console)
+ [自動重試組建 (AWS CLI)](#auto-retry-build-cli)
+ [自動重試組建 (AWS SDKs)](#auto-retry-build-sdks)

## 自動重試組建 （主控台）
<a name="auto-retry-build-console"></a>

1. 開啟 AWS CodeBuild 主控台，網址為 [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home)：//。

1. 選擇**建立專案**。如需詳細資訊，請參閱 [建立組建專案 (主控台)](create-project.md#create-project-console) 及 [執行建置 (主控台)](run-build-console.md)。
   +  在 **Environment (環境)** 中：
     +  針對**自動重試限制**，輸入建置失敗後所需的自動重試次數上限。

1. 在**環境中**，選擇**其他組態**。

1. 繼續執行預設值，然後選擇**建立建置專案**。

## 自動重試組建 (AWS CLI)
<a name="auto-retry-build-cli"></a>
+ 執行 **create-project** 命令：

  ```
  aws codebuild create-project \
      --name "<project-name>" \
      --auto-retry-limit <auto-retry-limit> \
      --source "<source>" \
      --artifacts {<artifacts>} \
      --environment "{\"type\": \"environment-type>\",\"image\": \"image-type>\",\"computeType\": \"compute-type>\"}" \
      --service-role "service-role>"
  ```

  在上述命令中，取代下列預留位置：
  + *<auto-retry-limit>*：將自動重試限制設定為建置失敗後所需的自動重試次數上限。
  + *<project-name>*、*<source>*、*<artifacts>*、*environ-type>*、*image-type>*、*comput-type>* 和 *service-role>*：設定所需的專案組態設定。

## 自動重試組建 (AWS SDKs)
<a name="auto-retry-build-sdks"></a>

如需 AWS CodeBuild 搭配 AWS SDKs 使用 的詳細資訊，請參閱 [AWS SDKs和工具參考](sdk-ref.md)。