AWS ECS Fargate + RDS 2層アーキテクチャ ハンズオン手順書

検索欄に AmazonECSTaskExecutionRolePolicy と入力 → チェックを入れる

handson-vpc を選択 → アクション → 「VPCの設定を編集」

「新しいサブネットを追加」ボタンで6つをまとめて作成し、サブネットを作成

handson-subnet-public-1a を選択 → アクション → 「サブネットの設定を編集」

handson-subnet-public-1c についても同様に設定します。

作成後、画面上部のバナーの「VPCにアタッチ」をクリック（または アクション → 「VPCにアタッチ」）

状態が 「Attached」 になっていることを確認します。

handson-rt-public を選択 → 「ルート」タブ → ルートを編集 → ルートを追加

「サブネットの関連付け」タブ → サブネットの関連付けを編集

以下 2つにチェック → 関連付けを保存

• handson-subnet-public-1a
• handson-subnet-public-1c

新しいルートテーブルを作成します：

handson-rt-private-ecs を選択 → 「ルート」タブ → ルートを編集 → ルートを追加

「サブネットの関連付け」タブ → サブネットの関連付けを編集

以下 2つにチェック → 関連付けを保存

• handson-subnet-private-ecs-1a
• handson-subnet-private-ecs-1c

インバウンドルール：

アウトバウンドルール：デフォルト（すべてのトラフィックを許可）のまま

インバウンドルール：

インバウンドルール：

mkdir ~/handson-app && cd ~/handson-app

package.json の作成：

cat > package.json <<'EOF'
{
  "name": "handson-app",
  "version": "1.0.0",
  "main": "app.js",
  "dependencies": {
    "express": "^4.18.0",
    "pg": "^8.11.0"
  }
}
EOF

cat > app.js <<'EOF'
const express = require('express');
const { Pool } = require('pg');
const os = require('os');
const app = express();

const pool = new Pool({
  host:     process.env.DB_HOST,
  port:     5432,
  user:     process.env.DB_USER     || 'admin',
  password: process.env.DB_PASSWORD,
  database: process.env.DB_NAME     || 'handson_db',
  ssl:      { rejectUnauthorized: false },
  max:      10
});

async function initDb() {
  await pool.query(`
    CREATE TABLE IF NOT EXISTS users (
      id         SERIAL PRIMARY KEY,
      name       VARCHAR(100) NOT NULL,
      email      VARCHAR(200) NOT NULL UNIQUE,
      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
    )
  `);
  const { rowCount } = await pool.query('SELECT 1 FROM users LIMIT 1');
  if (rowCount === 0) {
    await pool.query(`
      INSERT INTO users (name, email) VALUES
        ('田中 太郎', 'taro@example.com'),
        ('鈴木 花子', 'hanako@example.com'),
        ('佐藤 一郎', 'ichiro@example.com')
    `);
    console.log('Sample data inserted');
  }
  console.log('DB initialized');
}

initDb().catch(err => console.error('DB init error:', err.message));

app.get('/health', (req, res) => {
  res.json({ status: 'ok', container: os.hostname() });
});

app.get('/', (req, res) => {
  res.json({
    message: 'ECS Fargate app is running!',
    container: os.hostname(),
    tier: 'ecs-fargate'
  });
});

app.get('/users', async (req, res) => {
  try {
    const result = await pool.query('SELECT * FROM users ORDER BY id');
    res.json({ count: result.rowCount, users: result.rows, container: os.hostname() });
  } catch (err) {
    res.status(500).json({ error: err.message, container: os.hostname() });
  }
});

app.listen(8080, () => {
  console.log('App listening on port 8080');
});
EOF

cat > Dockerfile <<'EOF'
FROM node:20-alpine
WORKDIR /app
COPY package.json .
RUN npm install --production
COPY app.js .
EXPOSE 8080
CMD ["node", "app.js"]
EOF

【AWSアカウントID】 を手順2でメモした12桁のIDに置き換えて実行します：

aws ecr get-login-password --region ap-northeast-1 | \
  docker login --username AWS --password-stdin \
  【AWSアカウントID】.dkr.ecr.ap-northeast-1.amazonaws.com

Login Succeeded と表示されれば成功です。

【AWSアカウントID】 を置き換えて実行します：

# イメージビルド
docker build -t handson-app .

# ECR用にタグ付け
docker tag handson-app:latest \
  【AWSアカウントID】.dkr.ecr.ap-northeast-1.amazonaws.com/handson-ecr:latest

# ECRにプッシュ
docker push \
  【AWSアカウントID】.dkr.ecr.ap-northeast-1.amazonaws.com/handson-ecr:latest

latest: digest: sha256:... と表示されれば成功です。

「追加設定」セクションをクリックして展開します。

「コンテナ - 1」セクションを入力します：

「環境変数」セクションで「環境変数を追加」をクリックし、以下を入力します：

「ログ収集の設定」セクション：

ヘルスチェック設定：

2つのタスクのステータスが 「RUNNING」 になっていることを確認します。

2つのFargateタスクのIPアドレスが 「healthy」 になっていることを確認します。

手順13でメモした ALBのDNS名をブラウザのアドレスバーに入力してアクセスします：

ブラウザで /health や /users に複数回アクセスすると、レスポンスの "container" フィールド（コンテナのホスト名）が2つの異なる値で切り替わることを確認します。

ECSコンソールでタスクを1つ「停止」すると、ECSサービスが自動的に新しいタスクを起動します。

タスクが停止されても：

• ALBがもう一方のタスクにルーティングを切り替えるため、ブラウザからのアクセスはエラーなく継続されます
• ECSサービスが自動的に新しいタスクを起動し、希望タスク数（2）に戻します

Node.jsアプリのログ（DB initialized、App listening on port 8080 など）が確認できます。

全タスクが停止したことを確認後 → アクション → 「サービスを削除」

「最終スナップショットを作成しますか？」→ いいえ を選択
確認テキスト（delete me）を入力して 削除

確認テキスト（delete）を入力して削除します（イメージも同時に削除されます）。

削除には数分かかります。ステータスが「削除済み」になるまで待ちます。

デタッチ完了後 → 再度 アクション → 「インターネットゲートウェイを削除」

sg-rds → sg-ecs → sg-alb の順に削除します（依存関係があるため逆順）。

サブネット 6つ → ルートテーブル（handson-rt-private-ecs → handson-rt-public）→ VPC（handson-vpc）の順に削除します。