本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 AWS CodeBuild 中自动重试构建
<a name="auto-retry-build"></a>

您可以使用 AWS CodeBuild 控制台、AWS CLI 或 AWS SDK 在 AWS CodeBuild 中自动重试构建。启用自动重试功能后，CodeBuild 将在构建失败后使用项目的服务角色自动调用 `RetryBuild`，直至达到指定限制。例如，如果自动重试限制设置为二，则 CodeBuild 将调用 `RetryBuild` API 来自动重试您的构建，最多再重试两次。

**注意**  
CodeBuild 不支持 CodePipeline 的自动重试。

**Topics**
+ [自动重试构建（控制台）](#auto-retry-build-console)
+ [自动重试构建（AWS CLI）](#auto-retry-build-cli)
+ [自动重试构建（AWS SDK）](#auto-retry-build-sdks)

## 自动重试构建（控制台）
<a name="auto-retry-build-console"></a>

1. 从 [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home) 打开 AWS CodeBuild 控制台。

1. 选择**创建项目**。有关更多信息，请参阅 [创建构建项目（控制台）](create-project.md#create-project-console) 和 [运行构建（控制台）](run-build-console.md)。
   +  在**环境**中：
     +  对于**自动重试限制**，请输入在构建失败后希望进行的最大自动重试次数。

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>*、*<environment-type>*、*<image-type>*、*<compute-type>* 和 *<service-role>*：设置所需的项目配置设置。

## 自动重试构建（AWS SDK）
<a name="auto-retry-build-sdks"></a>

有关将 AWS CodeBuild 与 AWS 开发工具包结合使用的更多信息，请参阅[AWS SDKs 和工具参考](sdk-ref.md)。