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

# AWS CodeBuild エージェントを使用してビルドをローカルで実行する
<a name="use-codebuild-agent"></a>

 AWS CodeBuild エージェントを使用して、ローカルマシンで CodeBuild ビルドを実行できます。x86\$164 および ARM プラットフォームで使用できるエージェントがあります。

通知にサブスクライブして、 エージェントの新しいバージョンがリリースされたときに通知を受信できます。

## 前提条件
<a name="use-codebuild-agent.prerequisites"></a>

開始する前に、以下を実行する必要があります。
+ ローカルマシンで Git をインストールします。
+ ローカルマシンで、[Docker](https://www.docker.com/) をインストールしてセットアップします。

## ビルドイメージの設定方法
<a name="use-codebuild-agent.setup-image"></a>

ビルドイメージを設定する必要があるのは、エージェントを初めて実行するとき、またはイメージが変更されたときだけです。

**ビルドイメージの設定方法**

1. 厳選された Amazon Linux 2 イメージを使用する場合は、次のコマンドを使用して、[https://gallery.ecr.aws/codebuild/amazonlinux-x86\$164-standard](https://gallery.ecr.aws/codebuild/amazonlinux-x86_64-standard) の CodeBuild パブリック Amazon ECR リポジトリからイメージをプルできます。

   ```
   $ docker pull public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0
   ```

   その代わりに別の Linux イメージを使用する場合は、以下のステップを実行してください。

   1. CodeBuild イメージレポジトリをクローンします。

      ```
      $ git clone https://github.com/aws/aws-codebuild-docker-images.git
      ```

   1. イメージディレクトリを変更します。この例では、`aws/codebuild/standard:5.0` イメージを使用します。

      ```
      $ cd aws-codebuild-docker-images/ubuntu/standard/5.0
      ```

   1. イメージを構築します。これには数分間かかります。

      ```
      $ docker build -t aws/codebuild/standard:5.0 .
      ```

1. CodeBuild エージェントをダウンロードします。

   エージェントの x86\$164 バージョンをダウンロードするには、次のコマンドを実行します。

   ```
   $ docker pull public.ecr.aws/codebuild/local-builds:latest
   ```

   次のコマンドを使用して、ARM バージョンのエージェントをダウンロードしてインストールします。

   ```
   $ docker pull public.ecr.aws/codebuild/local-builds:aarch64
   ```

1. <a name="codebuild-agent-sha"></a>CodeBuild エージェントは、[https://gallery.ecr.aws/codebuild/local-builds](https://gallery.ecr.aws/codebuild/local-builds) から入手できます。

   エージェントの x86\$164 バージョンのセキュアハッシュアルゴリズム (SHA) 署名は次のとおりです。

   ```
   sha256:ccb19bdd7af94e4dc761e4c58c267e9455c28ec68d938086b4dc1cf8fe6b0940
   ```

   エージェントの ARM バージョンの SHA 署名は次のとおりです。

   ```
   sha256:7d7b5d35d2ac4e062ae7ba8c662ffed15229a52d09bd0d664a7816c439679192
   ```

   SHA を使用してエージェントのバージョンを識別できます。エージェントの SHA 署名を表示するには、次のコマンドを実行して、`RepoDigests` の下で SHA を探します。

   ```
   $ docker inspect public.ecr.aws/codebuild/local-builds:latest
   ```

## CodeBuild エージェントを実行する
<a name="use-codebuild-agent.run-agent"></a>

**CodeBuild エージェントを実行するには**

1. ビルドプロジェクトソースを含むディレクトリに移動します。

1. [codebuild.sh](https://github.com/aws/aws-codebuild-docker-images/blob/master/local_builds/codebuild_build.sh) スクリプトをダウンロードします。

   ```
   $ curl -O  https://raw.githubusercontent.com/aws/aws-codebuild-docker-images/master/local_builds/codebuild_build.sh
   $ chmod +x codebuild_build.sh
   ```

1. `codebuild_build.sh` スクリプトを実行し、コンテナイメージおよび出力ディレクトリを指定します。

   x86\$164 ビルドを実行するには、次のコマンドを実行します。

   ```
   $ ./codebuild_build.sh -i <container-image> -a <output directory>
   ```

   ARM ビルドを開始するには、次のコマンドを実行します。

   ```
   $ ./codebuild_build.sh -i <container-image> -a <output directory> -l public.ecr.aws/codebuild/local-builds:aarch64
   ```

   *<container-image>* は、コンテナイメージの名前 (`aws/codebuild/standard:5.0` または `public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0` など) に置き換えてください。

   スクリプトはビルドイメージを起動し、現在のディレクトリにあるプロジェクトを使用してビルドを実行します。ビルドプロジェクトの場所を指定するには、`-s <build project directory>` オプションをスクリプトコマンドに追加します。

## CodeBuild エージェントの新しいバージョンに関する通知の受信
<a name="receive-codebuild-agent-notifications"></a>

Amazon SNS 通知をサブスクライブして、 AWS CodeBuild エージェントの新しいバージョンがリリースされたときに通知を受け取ることができます。

**CodeBuild エージェントの通知にサブスクライブするには**

1. Amazon SNS コンソールの[https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home)を開いてください。

1. ナビゲーションバーで、まだ選択されていない場合は、 AWS リージョンを**米国東部 (バージニア北部)** に変更します。サブスクライブしている Amazon SNS 通知がこの AWS リージョンで作成されるため、このリージョンを選択する必要があります。

1. ナビゲーションペインで [**Subscriptions**] を選択してください。

1. [**Create subscription**] を選択してください。

1. **[Create subscription]** (サブスクリプションの作成) で、次の操作を行います。

   1. **[Topic ARN]** (トピック ARN) で、以下の Amazon リソースネーム (ARN) を使用します。

      ```
      arn:aws:sns:us-east-1:850632864840:AWS-CodeBuild-Local-Agent-Updates
      ```

   1. [**プロトコル**] で、[**E メール**] または [**SMS**] を選択します。

   1. [**エンドポイント**] で、通知を受信する場所 (E メールまたは SMS) を選択します。E メール、住所、または電話番号 (市外局番を含む) を入力します。

   1. [**Create subscription**] (サブスクリプションの作成) を選択します。

   1. **[Email]** (E メール) を選択した場合は、サブスクリプションの確認を求める E メールが届きます。E メールの指示に従ってサブスクリプションを完了します。

      通知が不要になった場合は、次の手順で受信登録を解除します。

**CodeBuild エージェントの通知のサブスクリプションを解除するには**

1. Amazon SNS コンソールの[https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home)を開いてください。

1. ナビゲーションペインで [**Subscriptions**] (サブスクリプション) を選択します。

1. サブスクリプションを選択し、**[Actions]** (アクション) から **[Delete subscriptions]** (サブスクリプションの削除) を選択します。確認を求められたら [**Delete**] (削除) を選択します。