プレゼンテーション層の構築
NginxのフロントエンドをECS/Fargateにデプロイします。手順はアプリケーション層と同様ですので、重複する説明は省略します。
1. ソースコードの修正
Docker Compose環境では、フロントエンドとAPIは同じマシン上で動作していたため、script.js のAPI接続先は http://localhost:8000 でした。しかし、ECS環境ではフロントエンドとAPIはそれぞれ別のFargateタスクとして独立して動作しており、localhost ではAPIにアクセスできません。そこで、API接続先をAPI用ALBのDNS名に変更することで、フロントエンドからALB経由でAPIにリクエストを送る構成にします。
Visual Studio Codeのエクスプローラーから front/script.js を開いてください。ファイルの1行目に以下のような記述があります。
const API_URL = 'http://localhost:8000';
この http://localhost:8000 の部分を、先ほど作成したAPI用ALBのDNS名に変更します。ALBのDNS名は、EC2コンソールの「ロードバランサー」から note-app-api-alb を選択して確認できます。
const API_URL = 'http://<API用ALBのDNS名>';
変更したら、ファイルを保存してください。
| 💡 ポイント |
|---|
ローカル環境ではhttp://localhost:8000でAPIに接続していましたが、ECS環境ではフロントエンドとAPIが別々のタスクで動作するため、API用ALBのDNS名を指定する必要があります。 |
2. イメージのビルドとプッシュ
API層と同じ手順で、フロントエンドのDockerイメージをビルドし、ECRにプッシュします。
2.1 イメージのビルド
Visual Studio Codeのターミナルで front フォルダに移動します。API層のビルド時に api フォルダにいる場合は、以下のコマンドで移動してください。
cd ../front
現在のディレクトリが front フォルダであることを確認します。
Macの場合:
pwd
Windowsの場合:
cd
どちらの場合も、表示されたパスの末尾が front になっていれば正しいディレクトリにいます。以下のコマンドでイメージをビルドします。
docker build --platform linux/amd64 -t note-app-front:v1 .
2.2 ECRリポジトリの作成

ECRコンソールでフロント用のリポジトリを作成します。API層と同じ手順で「リポジトリを作成」をクリックし、下記の内容を設定してください。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| リポジトリ名 | note-app-front | フロントコンテナを識別するため |
| イメージタグのミュータビリティ | Mutable | デフォルトのまま |
| 暗号化設定 | AES-256 | デフォルトのまま |

入力が完了したら「作成」をクリックします。リポジトリ一覧に note-app-front が表示されれば成功です。

2.3 タグの付与
docker tag note-app-front:v1 <AWSアカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/note-app-front:v1
ローカルのイメージに、ECRリポジトリのURIをタグとして付与します。
2.4 ECRリポジトリへのプッシュ
docker push <AWSアカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/note-app-front:v1
プッシュが完了したら、ECRコンソールで note-app-front リポジトリにイメージが登録されていることを確認してください。

3. ALBとターゲットグループの作成

API層と同様に、フロントエンド用のALBとターゲットグループをEC2コンソールで作成します。
3.1 ターゲットグループの作成
EC2コンソールの「ターゲットグループ」から「ターゲットグループの作成」をクリックします。下記の内容を設定してください。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| ターゲットタイプ | IPアドレス | Fargateではインスタンスではなく、タスクごとに割り振られるIPアドレスでルーティングするため |
| ターゲットグループ名 | note-app-front-tg | ターゲットグループを識別するため |
| プロトコル | HTTP | HTTP通信を使用するため |
| ポート | 80 | Nginxがリッスンするポート |
| VPC | CloudFormation出力値のVPCIdに対応するVPC |
CloudFormationで作成したVPCを選択 |
| ヘルスチェックパス | / | ルートパスで応答確認 |

「次へ」をクリックし、ターゲットの登録はスキップして「次へ」をクリックします。

「ターゲットグループの作成」をクリックします。

無事にターゲットグループが作成されれば、ここまでの操作は成功です。

3.2 ALBの作成
EC2コンソールの「ロードバランサー」から「ロードバランサーの作成」→「Application Load Balancer」の「作成」をクリックします。

下記の内容を設定してください。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| ロードバランサー名 | note-app-front-alb | ALBを識別するため |
| スキーム | インターネット向け | インターネットからアクセスを受け付けるため |
| IPアドレスタイプ | IPv4 | 標準的なIPv4を使用するため |
| VPC | CloudFormation出力値のVPCIdに対応するVPC |
CloudFormationで作成したVPCを選択 |
| マッピング | CloudFormation出力値のPublicSubnet1Id、PublicSubnet2Idに対応するサブネット |
パブリックサブネットを選択 |
| セキュリティグループ | CloudFormation出力値のALBSecurityGroupIdに対応するSG |
CloudFormationで作成したALB用セキュリティグループを選択 |

リスナーの設定
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| プロトコル | HTTP | HTTPでリクエストを受け付けるため |
| ポート | 80 | 標準的なHTTPポート |
| デフォルトアクション | note-app-front-tgに転送 | 先ほど作成したターゲットグループを選択 |

「ロードバランサーの作成」をクリックします。

ロードバランサー一覧に note-app-front-alb が表示されれば成功です。

| 💡 ポイント |
|---|
本来であれば、APIとフロントエンドは1つのALBにまとめ、リスナールールで振り分けるのが一般的です。たとえば、独自ドメインを取得して api.example.com はAPIへ、app.example.com はフロントエンドへ振り分けるホストベースルーティングが代表的な方法です。ただし、この方法には独自ドメインの取得が必要になります。今回のハンズオンではドメインの取得は行わないため、APIとフロントエンドでそれぞれ別のALBを作成しています。ALBが2つになることでコストは増えますが、ハンズオンの手順をシンプルに保つことを優先しています。 |
4. タスク定義の作成

API層と同様に、フロントエンド用のタスク定義を作成します。「タスク定義」→「新しいタスク定義の作成」をクリックし、下記の内容を設定してください。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| タスク定義ファミリー | note-app-front | タスク定義を識別するため |
| 起動タイプ | AWS Fargate | サーバレスで実行するため |
| タスクサイズ - CPU | 1 vCPU | 最小限のリソース |
| タスクサイズ - メモリ | 3 GB | 最小限のリソース |

4.1 コンテナの設定
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| 名前 | front | コンテナを識別するため |
| イメージURI | <AWSアカウントID>.dkr.ecr.ap-northeast-1.amazonaws.com/note-app-front:v1 | ECRにプッシュしたイメージ |
| コンテナポート | 80 | Nginxがリッスンするポート |

すべて入力が終わったら「作成」をクリックします。

無事にタスク定義が作成されれば、ここまでの操作は完了です。

5. ECSサービスの作成

API層と同様の手順で、フロントエンド用のECSサービスを作成します。クラスターは既存のnote-app-clusterを使用します。「サービス」タブから「作成」をクリックし、下記の内容を設定してください。
5.1 サービスの詳細
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| タスク定義ファミリー | note-app-front | 作成したタスク定義を選択 |
| タスク定義のリビジョン | 空欄のまま | 最新リビジョンが自動的に使用されるため |
| サービス名 | note-app-front-service | サービスを識別するため |

5.2 環境
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| 既存のクラスター | note-app-cluster | API層と同じクラスターが選択されていることを確認 |
| コンピューティングオプション | キャパシティプロバイダー戦略 | デフォルトのまま |
| キャパシティプロバイダー | FARGATE | Fargateで実行するため |
| プラットフォームバージョン | LATEST | 最新のFargateプラットフォームを使用するため |

5.3 デプロイ設定
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| スケジューリング戦略 | レプリカ | デフォルトのまま |
| 必要なタスク | 1 | 最小構成 |
| アベイラビリティゾーンのリバランスを有効にする | チェックあり | デフォルトのまま |
| ヘルスチェックの猶予期間 | 0 | デフォルトのまま |

5.4 ネットワーキング
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| VPC | CloudFormation出力値のVPCIdに対応するVPC |
CloudFormationで作成したVPCを選択 |
| サブネット | CloudFormation出力値のPrivateSubnet1Id、PrivateSubnet2Idに対応するサブネット |
2つのプライベートサブネットを選択 |
| セキュリティグループ | CloudFormation出力値のFrontSecurityGroupIdに対応するSG |
フロントタスク用SG |
| パブリックIP | オフ | プライベートサブネットに配置するためパブリックIPは不要 |

5.5 ロードバランシング
「ロードバランシングを使用」にチェックを入れ、下記の内容を設定してください。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| ロードバランサーの種類 | Application Load Balancer | HTTP/HTTPSのルーティングを行うため |
| コンテナ | front 80:80 | タスク定義で設定したコンテナとポートを選択 |
| Application Load Balancer | 既存のロードバランサーを使用 | 先ほど作成したALBを使用するため |
| ロードバランサー | note-app-front-alb | 先ほど作成したALBを選択 |
| リスナー | 既存のリスナーを使用 | 先ほど作成したリスナーを使用するため |
| リスナーのポート | 80:HTTP | 先ほど作成したリスナーを選択 |
| ターゲットグループ | 既存のターゲットグループを使用 | 先ほど作成したターゲットグループを使用するため |
| ターゲットグループ名 | note-app-front-tg | 先ほど作成したターゲットグループを選択 |

5.6 サービスの自動スケーリング - オプション
API層と同様に設定します。
| 設定項目 | 値 | 設定の基準 |
|---|---|---|
| タスクの最小数 | 1 | 最低1つは常時起動するため |
| タスクの最大数 | 4 | 負荷に応じて最大4つまでスケールするため |
| スケーリングポリシータイプ | ターゲットの追跡 | メトリクスの目標値に基づいてタスク数を自動調整するため |
| ポリシー名 | front-cpu-scaling | スケーリングポリシーを識別するため |
| ECSサービスメトリクス | ECSServiceAverageCPUUtilization | CPU使用率を監視するため |
| ターゲット値 | 70 | CPU使用率が70%を超えたらスケールアウトするため |

すべての設定が完了したら「作成」をクリックします。
note-app-front-serviceのステータスが「アクティブ」となり、デプロイとタスクが「1/1 件の実行中のタスク」となれば、ここまでは成功です。
6. 動作確認
フロント用ALBのDNS名を確認し、ブラウザで開きます。
http://<フロント用ALBのDNS名>
無事にノートアプリケーションが起動することを確認します。

APIとの接続もできているかを確認するため、タイトルと内容に任意の値を入力し、「追加」をクリックします。

入力した項目がノート一覧に表示されれば、APIとの連携もできているため、ここまでは成功です。
