プレゼンテーション層の構築

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との連携もできているため、ここまでは成功です。