翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS CodeBuild でのビルドを自動的に再試行
<a name="auto-retry-build"></a>

AWS CodeBuild コンソール、AWS CLI、または AWS SDK を使用して、AWS CodeBuild でのビルドを自動的に再試行できます。自動再試行を有効にすると、CodeBuild は、ビルドが失敗した後、指定された制限回数までプロジェクトのサービスロールを使用して自動的に `RetryBuild` を呼び出します。例えば、自動再試行の制限が 2 に設定されている場合、CodeBuild は `RetryBuild` API を呼び出して、さらに最大 2 回までビルドを自動的に再試行します。

**注記**  
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. 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)」を参照してください。
   +  [**環境**] で以下の操作を行います。
     +  **[自動再試行の制限]** には、ビルドが失敗した後に希望する自動再試行の最大回数を入力します。

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 SDK と組み合わせて使用する方法については、「[AWS SDKsとツールのリファレンス](sdk-ref.md)」を参照してください。