# AWS CodeBuildを使ったDockerイメージの自動ビルドとECRへのプッシュ

## 目次

1. はじめに
2. AWS CodeBuildの概要
   2.1 CodeBuildとは
   2.2 利用するメリット
3. ECRのセットアップ
   3.1 ECRリポジトリの作成
4. CodeBuildプロジェクトの作成
   4.1 IAMロールの設定
   4.2 CodeBuildプロジェクトの設定
5. buildspec.ymlファイルの作成
   5.1 buildspec.ymlの構造
   5.2 Dockerイメージのビルドとプッシュ
6. CodeBuildプロジェクトの実行
   6.1 CodeBuildのトリガー
   6.2 成功と失敗の確認
7. よくある問題とトラブルシューティング
8. 最適化のヒント
9. まとめ

## 1. はじめに

Dockerイメージのビルドとデプロイは、効率的でスケーラブルなアプリケーション開発の基盤です。AWS CodeBuildとECR (Elastic Container Registry) を活用することで、このプロセスを自動化し、継続的インテグレーションパイプラインを構築できます。本記事では、その具体的な方法を詳しく解説します。

## 2. AWS CodeBuildの概要

### 2.1 CodeBuildとは

AWS CodeBuildは、フルマネージド型のビルドサービスで、継続的なインテグレーションパイプラインの一部としてコードをコンパイルし、単体テストを実行し、アーティファクト（例: Dockerイメージ）を生成することができます。

### 2.2 利用するメリット

- **スケーラビリティ**: 負荷に応じて自動でリソースを管理。
- **コスト効率**: 使用した分だけの課金モデル。
- **統合**: 他のAWSサービス（ECR、S3、Lambdaなど）とシームレスに統合可能。

## 3. ECRのセットアップ

### 3.1 ECRリポジトリの作成

AWSマネジメントコンソールでECRサービスを選択し、新しいDockerリポジトリを作成します。

```sh
aws ecr create-repository --repository-name my-docker-repo
```

- **パブリックまたはプライベート**: 必要に応じてデフォルトのリポジトリタイプを選択。
- **リポジトリポリシー**: アクセス権限を設定する。

## 4. CodeBuildプロジェクトの作成

### 4.1 IAMロールの設定

CodeBuildがECRや他のAWSリソースにアクセスするためには、IAMロールによる適切な権限の付与が必要です。

- **Policy**: `AmazonEC2ContainerRegistryPowerUser` 権限を持つ新しいIAMロールを作成。

### 4.2 CodeBuildプロジェクトの設定

AWSコンソールからCodeBuildの新しいプロジェクトを作成し、以下の項目を設定します。

- **ソース**: GitHubやCodeCommitなどのリポジトリから選択。
- **環境**: Docker `standard:4.0` などのビルダーイメージ。
- **サービスロール**: 先ほど作成したIAMロール。

## 5. buildspec.ymlファイルの作成

### 5.1 buildspec.ymlの構造

buildspec.ymlは、CodeBuildが実行するタスクを定義するためのファイルです。プロジェクトルートに保存しておきます。

### 5.2 Dockerイメージのビルドとプッシュ

以下の内容をbuildspec.ymlに記述します。

```yaml
version: 0.2

phases:
  pre_build:
    commands:
      - echo Logging in to Amazon ECR...
      - aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin <account>.dkr.ecr.us-west-2.amazonaws.com
  build:
    commands:
      - echo Build started on `date`
      - echo Building the Docker image...
      - docker build -t my-docker-repo .
      - docker tag my-docker-repo:latest <account>.dkr.ecr.us-west-2.amazonaws.com/my-docker-repo:latest
  post_build:
    commands:
      - echo Pushing the Docker image...
      - docker push <account>.dkr.ecr.us-west-2.amazonaws.com/my-docker-repo:latest
artifacts:
  files:
    - '**/*'
  discard-paths: yes
```

## 6. CodeBuildプロジェクトの実行

### 6.1 CodeBuildのトリガー

GitHubなどのリポジトリと連携し、プッシュ時に自動でCodeBuildをトリガーします。

- **ウェブフック**: リポジトリのプッシュをトリガーとして設定。

### 6.2 成功と失敗の確認

CodeBuildの実行結果はAWSコンソールで確認が可能です。ビルド履歴からログを閲覧し、エラーを特定します。

## 7. よくある問題とトラブルシューティング

- **ログインエラー**: ECRにログインする際の認証エラーはIAMポリシーを確認。
- **ビルド失敗**: Dockerfileやソースコードのエラーをチェック。

## 8. 最適化のヒント

- **キャッシュ戦略**: Dockerレイヤーキャッシュを活用し、ビルド時間を短縮。
- **コンカレントビルド**: 同時に複数のビルドを実行し、デプロイメントスピードを向上。

## 9. まとめ

AWS CodeBuildを使用することで、DockerイメージのビルドとECRへのプッシュが自動化され、より効率的なデプロイメントパイプラインを構築できます。DevOps環境で継続的デリバリーをサポートし、ビジネスの迅速な成長に寄与します。 [cv:issue_marketplace_engineer]

AWS CodeBuildを使ったDockerイメージの自動ビルドとECRへのプッシュ

目次

続きを読むには単価診断を受けてください（30秒）