コンテナ化とDocker Composeの実装

この章では、サンプルアプリケーションをコンテナ化し、Docker Compose で一式を起動できるようにする課題に取り組みます。

1. 目的・背景

sns-camp-api と sns-camp-front をコンテナ化することで、環境に依存しない形でアプリケーションを動かせるようにします。あわせて Docker Compose を使い、API・フロントエンド・データベースの3つをローカルでまとめて起動できる状態を目標にします。

💡 ポイント
本課題は、要件定義や設計を自分で考えるスキルを高めるため、要件をあえて抽象的に記載しています。進める中で不明点がある場合は、講師への質問 から事前に相談してください。メンタリング当日に「わからなくて進んでいない」状態になると活用できる時間が限られてしまうため、迷ったら途中段階でもこまめに質問を出すことを推奨します。

2. 実施要件

2.1 使用するサンプルアプリケーション

AWS 中間課題・最終課題で発展させてきた sns-camp-api と sns-camp-front を継続して使用してください。

2.2 sns-camp-api のコンテナ化(必須)

sns-camp-api を Dockerfile でコンテナ化してください。マルチステージビルドを利用してイメージサイズを抑えることが目安です。

2.3 sns-camp-front のコンテナ化(任意)

sns-camp-front のコンテナ化は必須ではありません。AWS 最終課題で Amplify を採用した場合はホスティング側でビルド・配信が完結するため、コンテナ化する必要はありません。CloudFront + S3 を採用した場合や、余裕がある場合は Dockerfile でコンテナ化しても構いません。

2.4 コンテナ間の連携

sns-camp-api と DB をまとめて起動できるように、Docker Compose で構成してください。sns-camp-front をコンテナ化した場合はあわせて Compose に含めてください。API から DB のデータを読み書きできる状態が目標です。

2.5 対象外

本課題では、以下は対象外です。これらは後続の講座で扱います。

  • AWS 上でのコンテナ実行環境の構築(本講座の最終課題で実施します)
  • インフラのコード化(Terraform 講座で実施します)
  • CI/CDパイプラインの構築(CI/CD 講座で実施します)
  • 非機能要件の実装(非機能要件講座で実施します)

3. 判定基準

3.1 動作確認

以下のコマンドで一式が起動することを確認してください。

docker compose up -d

以下の 3 つの curl コマンドで動作を確認してください。

まず sns-camp-api の疎通確認用エンドポイント GET /health を呼び出します。

curl -i http://localhost:8080/health

以下のようなレスポンスが返ります。

HTTP/1.1 200 OK
Content-Type: application/json

{"status": "ok"}

続いて、POST /api/v1/auth/register でユーザを登録し、API 経由で DB に読み書きできることを確認します。

curl -i -X POST http://localhost:8080/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username": "yamada", "email": "yamada@example.com", "password": "password123", "display_name": "山田太郎"}'

以下のようなレスポンスが返ります。

HTTP/1.1 201 Created
Content-Type: application/json

{"data": {"token": "eyJ...", "user": {"id": 1, "username": "yamada", ...}}}

最後に、登録レスポンスに含まれる token を使って GET /api/v1/auth/me を呼び出し、登録したユーザ情報を取得できることを確認します。

curl -i http://localhost:8080/api/v1/auth/me \
  -H "Authorization: Bearer <登録レスポンスの token>"

以下のようなレスポンスが返ります。

HTTP/1.1 200 OK
Content-Type: application/json

{"data": {"id": 1, "username": "yamada", "email": "yamada@example.com", "display_name": "山田太郎", ...}}

4. 課題提出

下記内容を提出フォームより提出してください(提出はプレミアムプランでご利用いただけます)。

項目 内容
概要 作成した Dockerfile および Docker Compose 構成の特徴・工夫した点を簡潔に記載する
実装コード Dockerfile、docker-compose.yml、および反映した GitHub リポジトリの URL を記載する
動作確認 docker compose up でコンテナが起動し、sns-camp-api と DB が連携して動作する様子を、コマンド実行結果として記載する
まとめ 実装中に苦労したこと、工夫したこと、学んだことを記載する

応用課題の採点はプレミアムプランでご利用いただけます。

プランのアップグレード