AWS CodePipeline + CodeBuild CI/CD ハンズオン

GitHub で新規リポジトリ handson-app を Public または Private で作成します。

以下の 3 ファイルをリポジトリに追加します。

app.js（Node.js の簡単な HTTP サーバー）

const http = require('http');
const PORT = process.env.PORT || 3000;
const VERSION = process.env.APP_VERSION || 'v1.0';

const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end(`Hello from ECS Fargate! Version: ${VERSION}\n`);
});

server.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`);
});

Dockerfile

FROM node:20-alpine
WORKDIR /app
COPY app.js .
EXPOSE 3000
CMD ["node", "app.js"]

buildspec.yml（CodeBuild のビルド定義）

version: 0.2

env:
  variables:
    AWS_DEFAULT_REGION: ap-northeast-1
    IMAGE_REPO_NAME: handson-app
  parameter-store:
    AWS_ACCOUNT_ID: /handson/aws-account-id

phases:
  pre_build:
    commands:
      - echo Logging in to Amazon ECR...
      - ECR_URI=${AWS_ACCOUNT_ID}.dkr.ecr.${AWS_DEFAULT_REGION}.amazonaws.com/${IMAGE_REPO_NAME}
      - aws ecr get-login-password --region $AWS_DEFAULT_REGION | docker login --username AWS --password-stdin $ECR_URI
      - IMAGE_TAG=$(echo $CODEBUILD_RESOLVED_SOURCE_VERSION | cut -c 1-7)
      - echo Image tag is $IMAGE_TAG
  build:
    commands:
      - echo Building Docker image...
      - docker build -t $ECR_URI:$IMAGE_TAG .
      - docker tag $ECR_URI:$IMAGE_TAG $ECR_URI:latest
  post_build:
    commands:
      - echo Pushing Docker image...
      - docker push $ECR_URI:$IMAGE_TAG
      - docker push $ECR_URI:latest
      - echo Writing imagedefinitions.json...
      - printf '[{"name":"handson-app","imageUri":"%s"}]' $ECR_URI:$IMAGE_TAG > imagedefinitions.json

artifacts:
  files: imagedefinitions.json

buildspec.yml から参照するアカウント ID を SSM に保存します。

AWS マネジメントコンソールで 「Elastic Container Registry」 を検索して開きます。「リポジトリを作成」 をクリックします。

「リポジトリを作成」をクリックします。

古いイメージが蓄積しないよう、最新 10 件のみ保持するポリシーを設定します。

リポジトリを開き 「ライフサイクルポリシー」→「ルールを作成」 をクリックします。

AWS マネジメントコンソールで 「CodePipeline」 を検索して開きます。左メニューの 「設定」→「接続」→「接続を作成」 をクリックします。

「GitHub に接続」をクリックします。

GitHub の認証ページにリダイレクトされます。「AWS Connector for GitHub」 アプリのインストールを許可します。

「CodeBuild」 を検索して開きます。「ビルドプロジェクトを作成する」 をクリックします。

プロジェクト作成後、自動作成された IAM ロール codebuild-handson-role に以下のポリシーを追加します。

IAM コンソール → ロール → codebuild-handson-role → 「許可を追加」→「ポリシーをアタッチ」

• AmazonEC2ContainerRegistryPowerUser — ECR への push 権限
• AmazonSSMReadOnlyAccess — SSM パラメーター読み取り権限

CodePipeline コンソールで 「パイプラインを作成する」 をクリックします。

「次へ」をクリックします。

「次へ」をクリックします。

「次へ」をクリックします。

「次へ」→「パイプラインを作成する」をクリックします。

app.js の VERSION を変更します。

const VERSION = process.env.APP_VERSION || 'v2.0';  // v1.0 → v2.0 に変更

CodePipeline コンソールで handson-pipeline を開きます。数秒〜数十秒でパイプラインが自動起動し、各ステージが順に実行されます。

ECS コンソール → クラスター → handson-ecs-cluster → サービス → handson-ecs-service → タスクタブを確認します。新しいタスクが起動し旧タスクが停止すれば成功です。

ALB の DNS 名またはサービスのパブリック IP にアクセスして Version: v2.0 が表示されれば CI/CD パイプライン完成です。