AWS CodePipeline と CodeBuild でアップロードから自動デプロイする

前提条件

1. リージョン: ap-northeast-1（東京）
2. AWS マネジメントコンソールにログイン済みであること
3. S3・CodePipeline・CodeBuild の操作と、IAM ロール（CodePipeline・CodeBuild のサービスロール）の作成ができる権限があること
4. AWS CloudShell が使えること

S3 のバケットとオブジェクトの基本は「Amazon S3 でバケットを作成しオブジェクトを管理する」で解説しています。

作成するリソース一覧

S3 のバケット名は全世界で一意にする必要があるため、名前の末尾に自分の AWS アカウント ID（12 桁）を付けます。以降の <アカウントID> は自分のアカウント ID に置き換えてください。

ステップ1: ソース用とデプロイ先の S3 バケットを作成する

1. AWS マネジメントコンソールにログインし、リージョンが ap-northeast-1（東京）であることを確認します
2. 画面右上のアカウント名をクリックし、表示されたアカウント ID（12 桁）を控えます
3. 上部の検索バーに S3 と入力し、表示された「S3」を選択します
4. 左側ナビゲーションの「汎用バケット」を選択し、「バケットを作成」をクリックします
5. 以下を設定します
   • バケット名前空間: グローバル名前空間（デフォルトのまま）
   • バケット名: cicd-handson-source-<アカウントID>
   • このバケットのブロックパブリックアクセス設定: 「パブリックアクセスをすべてブロック」にチェックが入ったまま
   • バケットのバージョニング: 有効にする
6. その他の項目はデフォルトのままにし、ページ下部の「バケットを作成」をクリックします

1. もう一度「バケットを作成」をクリックし、以下を設定します
   • バケット名前空間: グローバル名前空間（デフォルトのまま）
   • バケット名: cicd-handson-deploy-<アカウントID>
   • このバケットのブロックパブリックアクセス設定: 「パブリックアクセスをすべてブロック」にチェックが入ったまま
   • バケットのバージョニング: デフォルト（無効にする）のまま
2. その他の項目はデフォルトのままにし、「バケットを作成」をクリックします
3. バケット一覧に 2 つのバケットが表示されることを確認します

ステップ2: CloudShell でソースの zip を作成してアップロードする

1. コンソール上部のツールバーにある CloudShell のアイコンをクリックし、CloudShell を起動します（リージョンが ap-northeast-1 のままであることを確認します）
2. アカウント ID とバケット名を変数に入れます

ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
SRC_BUCKET=cicd-handson-source-${ACCOUNT_ID}
DEPLOY_BUCKET=cicd-handson-deploy-${ACCOUNT_ID}
echo ${SRC_BUCKET} ${DEPLOY_BUCKET}

1. 作業用のディレクトリを作り、ビルドの手順書 buildspec.yml を作成します。build フェーズで src/index.html の目印（__BUILD_NUMBER__ と __BUILD_TIME__）をビルド番号とビルド日時（UTC）に置き換えて dist/index.html に出力し、artifacts で dist の中身を成果物にします

mkdir -p ~/cicd-handson/src && cd ~/cicd-handson
cat > buildspec.yml <<'EOF'
version: 0.2

phases:
  build:
    commands:
      - echo "Build number ${CODEBUILD_BUILD_NUMBER}"
      - mkdir -p dist
      - BUILD_TIME=$(date -u '+%Y-%m-%d %H:%M:%S')
      - sed -e "s/__BUILD_NUMBER__/${CODEBUILD_BUILD_NUMBER}/" -e "s/__BUILD_TIME__/${BUILD_TIME}/" src/index.html > dist/index.html
      - cat dist/index.html

artifacts:
  base-directory: dist
  files:
    - '**/*'
EOF

1. 元になる src/index.html を作成します

cat > src/index.html <<'EOF'
<!DOCTYPE html>
<html lang="ja">
<head><meta charset="UTF-8"><title>CI/CD Handson</title></head>
<body>
  <h1>Hello CodePipeline v1</h1>
  <p>Build number: __BUILD_NUMBER__</p>
  <p>Built at (UTC): __BUILD_TIME__</p>
</body>
</html>
EOF

1. 2 つのファイルを site.zip にまとめます。buildspec.yml が zip のルートに来るように、作業ディレクトリの中で zip を作ります

zip -r site.zip buildspec.yml src
unzip -l site.zip

1. unzip -l の結果に buildspec.yml と src/index.html が表示されることを確認し、ソース用バケットにアップロードします

aws s3 cp site.zip s3://${SRC_BUCKET}/site.zip

ステップ3: パイプラインを作成する（パイプラインの設定とソースステージ）

1. 上部の検索バーに CodePipeline と入力し、表示された「CodePipeline」を選択します
2. 「パイプラインを作成する」をクリックします
3. 「Step 1: 作成オプションを選択する」で「カスタムパイプラインを構築する」を選択し、「次に」をクリックします
4. 「Step 2: パイプラインの設定を選択する」で以下を設定し、「次に」をクリックします
   • パイプライン名: cicd-handson-pipeline
   • サービスロール: 新しいサービスロール（ロール名は自動で入力されたままにします）
   • その他の項目はデフォルトのままにします（実行モードは既定の キュー）。パイプラインタイプを選ぶ項目は無く、V2 のパイプラインとして作成されます
5. 「Step 3: ソースステージを追加」で以下を設定します
   • ソースプロバイダー: Amazon S3
   • バケット: 入力欄をクリックし、候補から cicd-handson-source-<アカウントID> を選択します
   • S3 オブジェクトキー: site.zip
   • 「ソースの変更を自動的に検出する EventBridge ルールを作成」: チェックが入ったまま（site.zip の更新を EventBridge ルールで検知してパイプラインを起動します）
   • 「ステージ障害時の自動再試行を有効にする」はデフォルトのままにします
6. 「次に」をクリックします

ステップ4: ビルドステージで CodeBuild プロジェクトを作成する

1. 「Step 4: ビルドステージを追加する」で、ビルドプロバイダーの「その他のビルドプロバイダー」を選択し、AWS CodeBuild を選びます（既定の「コマンド」は、CodeBuild のプロジェクトを作らずにパイプラインの中でコマンドを実行する方式です。今回は buildspec.yml を使うので CodeBuild を選びます）
2. リージョンが アジアパシフィック (東京) であることを確認し、「プロジェクト名」の横の「プロジェクトを作成する」をクリックします
3. 別ウィンドウで CodeBuild のプロジェクト作成画面が開くので、以下を設定します
   • プロジェクト名: cicd-handson-build
   • 環境イメージ: マネージド型イメージ（オペレーティングシステムやイメージなど、環境のその他の項目はデフォルトのまま）
   • サービスロール: 新しいサービスロール（ロール名は自動で入力されたまま）
   • ビルド仕様: buildspec ファイルを使用する（Buildspec 名は空欄のまま。ソースのルートにある buildspec.yml が使われます）
   • その他の項目はデフォルトのままにします

1. 画面下部の「CodePipeline に進む」をクリックします。ウィンドウが閉じ、パイプラインの作成画面に「プロジェクト名」として cicd-handson-build が入ります
2. その他の項目（ビルドタイプ 単一ビルド、入力アーティファクト SourceArtifact）はデフォルトのままにし、「次に」をクリックします
3. 「Step 5: テストステージを追加」は「テストステージをスキップ」をクリックします（確認ダイアログが表示された場合は「スキップ」をクリックします）

ステップ5: デプロイステージを設定してパイプラインを作成する

1. 「Step 6: デプロイステージを追加する」で以下を設定します
   • デプロイプロバイダー: Amazon S3
   • リージョン: アジアパシフィック (東京)
   • 入力アーティファクト: BuildArtifact（自動で入っています）
   • バケット: 入力欄をクリックし、候補から cicd-handson-deploy-<アカウントID> を選択します
   • デプロイパス - オプショナル: 空欄のまま（バケットのルートに展開されます）
   • 「デプロイする前にファイルを抽出する」: チェックを入れる（ビルドの成果物は zip でアーティファクトストアに保存されているため、展開してからデプロイ先に置きます）
   • 「ステージ障害時の自動ロールバックを設定」はデフォルトのままにします
2. 「次に」をクリックします

1. 「Step 7: レビュー」で設定内容を確認し（パイプラインタイプが V2 になっています）、「パイプラインを作成する」をクリックします

ステップ6: 実行結果と展開されたファイルを確認する

パイプラインを作成すると、ソース用バケットにある site.zip を使って最初の実行が自動で始まります。

1. パイプラインの詳細画面で、Source → Build → Deploy の順に各ステージが進むのを待ちます（数分かかることがあります）
2. 3 つのステージがすべて「すべてのアクションが成功しました。」になったことを確認します

1. Build ステージのアクションの「詳細を表示」をクリックし、ビルドログに buildspec.yml の cat dist/index.html の出力（ビルド番号と日時が入った HTML）が表示されていることを確認します
2. CloudShell に戻り、デプロイ先のバケットに展開された index.html の中身を表示します

aws s3 ls s3://${DEPLOY_BUCKET}/
aws s3 cp s3://${DEPLOY_BUCKET}/index.html -

Hello CodePipeline v1 の見出しと、__BUILD_NUMBER__ が 1 に、__BUILD_TIME__ がビルドした日時に置き換わった HTML が表示されれば、S3 に置いた zip が CodeBuild でビルドされ、デプロイ先のバケットに展開されたことが確認できます。

ステップ7: zip を更新して自動で再実行されることを確認する

1. CloudShell で src/index.html の見出しを v2 に書き換え、zip を作り直してアップロードします

cd ~/cicd-handson
sed -i 's/Hello CodePipeline v1/Hello CodePipeline v2/' src/index.html
rm site.zip
zip -r site.zip buildspec.yml src
aws s3 cp site.zip s3://${SRC_BUCKET}/site.zip

1. CodePipeline のコンソールに戻り、パイプライン cicd-handson-pipeline の詳細画面を開きます。手動で「変更をリリースする」をクリックしなくても、新しい実行が始まることを確認します（始まるまで少し時間がかかることがあります）
2. 上部の「実行」タブ（または左側ナビゲーションの「履歴」）を選択して「実行履歴」を開き、2 つ目の実行のステータスが「成功しました」になったことを確認します。トリガーが CloudWatchEvent（EventBridge ルール）になっていて、zip のアップロードで自動的に始まったことが分かります。「ソースリビジョン」には S3 オブジェクトのバージョン ID が記録されています

1. CloudShell で、デプロイ先の index.html を再度表示します

aws s3 cp s3://${DEPLOY_BUCKET}/index.html -

見出しが Hello CodePipeline v2、ビルド番号が 2 に変わっていれば、ソースの更新をきっかけにパイプラインが自動で再実行され、新しい成果物がデプロイされたことが確認できます。