構築のヒント

ECS 上のコンテナに RDS 接続情報や API の URL を渡す方法をまとめます。本課題の本質は ECS によるコンテナ運用の理解にあり、環境変数の渡し方のパターンは本質的な学習対象ではないため、自力で調べて進めていただいて構いませんが、詰まった場合は以下のヒントを適宜参考にしてください。

1. バックエンド(sns-camp-api)に RDS 接続情報を渡す方法

展開して設定例を表示する

ECS では、.env ファイルを使わず、タスク定義の containerDefinitions に環境変数を直接書く形になります。接続先ホスト名・ポート・ユーザ名・パスワード・DB 名は environment で渡せます。

タスク定義(JSON 形式)での設定例は以下のようになります。

{
  "containerDefinitions": [
    {
      "name": "sns-camp-api",
      "image": "<ECRのイメージURI>",
      "environment": [
        {"name": "DB_HOST", "value": "sns-camp-db.xxxxx.ap-northeast-1.rds.amazonaws.com"},
        {"name": "DB_PORT", "value": "3306"},
        {"name": "DB_USER", "value": "admin"},
        {"name": "DB_PASSWORD", "value": "(RDSのパスワード)"},
        {"name": "DB_NAME", "value": "sns_camp"}
      ]
    }
  ]
}

あわせて、タスクを配置するサブネットから RDS のセキュリティグループへインバウンド(3306)が許可されていることを確認してください。

💡 ポイント
コンテナ講座では扱っていませんが、DB_PASSWORD のような機密情報は AWS Secrets Manager や Systems Manager Parameter Store に保管し、タスク定義の secrets セクションから参照する方法のほうが安全です。本番運用に近づける場合に検討してみてください。

2. ECS Service Auto Scaling の設定方法

展開して補足を表示する

コンテナ講座で扱っているのは ターゲット追跡スケーリング で、「ターゲット値(例: CPU 70%)を維持するようにタスク数を自動で増減する」仕組みです。スケールインの契機は、ターゲット値から少し下回った付近(おおよそ 0.9 × ターゲット値)で自動的に発生し、CPU 30% のような閾値を独立に指定することはできません。

実施要件(最小2・最大6、CPU70%でアウト、CPU30%でイン)のように閾値を独立させたい場合は、ステップスケーリング を使い、CloudWatch アラームを 2 つ用意してそれぞれにスケーリングポリシーを紐付けます。マネジメントコンソールの ECS → クラスター → サービス → 「Auto Scaling」タブから設定できます。

3. フロントエンド(sns-camp-front)に API の URL を渡す方法

展開して設定例を表示する

sns-camp-front は NEXT_PUBLIC_API_URL でバックエンド API の URL を指定します。この変数は Next.js のビルド時に埋め込まれるため、ECS のタスク定義で環境変数として渡しても反映されません。イメージをビルドする時点で正しい URL を埋め込む 必要があります。

Dockerfile で外部から値を受け取る命令として ARG(ビルド時の変数)と ENV(ビルド中・ランタイム両方で参照できる環境変数)があります。コンテナ講座では扱っていませんが、ARG でビルド時に値を受け取り、ENV でそれをランタイムまで引き継ぐ、という流れで Next.js の環境変数をイメージに焼き込めます。

sns-camp-front の Dockerfile の冒頭に、以下のように ARG と ENV を追記しておきます(Step 5 でコンテナ化済みであれば同じです)。

ARG NEXT_PUBLIC_API_URL
ENV NEXT_PUBLIC_API_URL=$NEXT_PUBLIC_API_URL

ECR にプッシュするイメージをビルドする際に、--build-arg で ALB の公開 URL を渡してください。

docker build \
  --build-arg NEXT_PUBLIC_API_URL=https://<ALBのドメイン>/api/v1 \
  -t sns-camp-front .

ビルド後のイメージを ECR にプッシュして、ECS のタスク定義で参照する形になります。API の URL が変わる場合は、イメージを再ビルドして再デプロイする必要がある点に注意してください。