今回作る構成
「TerraformでシンプルなAWS構成を作ろう」では、VPC・サブネット・セキュリティグループ・EC2といった基本的なリソースをTerraformで構築しました。このセクションでは、その構成をベースに以下の観点を追加し、より実践的な構成に挑戦します。
- 前回は1つの
main.tfにすべてのリソースを記述しましたが、今回は変更頻度とチームの責務を基準にモジュールを分割し、再利用可能な構成にします - 前回はtfstateをローカルに保存しましたが、今回はS3 + DynamoDBによるリモートバックエンドを導入し、チーム開発に対応できる構成にします
- 前回はパブリックサブネット1つにEC2を配置しましたが、今回はパブリック/プライベートサブネットを2つのアベイラビリティゾーンに作成し、可用性の高いマルチAZ構成にします
- 前回はEC2にアプリケーションを配置しましたが、今回はECS(Fargate)を使ってコンテナベースで動かします
- 前回はパブリックIPで直接アクセスしましたが、今回はRoute53 + ACM証明書でカスタムドメインとHTTPS通信を設定します
1. 独自ドメインの利用
このセクションでは、ALBとCloudFrontにカスタムドメインを設定してHTTPS通信を行います。そのため、独自ドメインの取得が事前に必要です。Route53ホストゾーンの作成やDNSレコードの設定はTerraformで自動的に行うため、ドメインの取得だけ済ませておけば問題ありません。
まだドメインを取得していない場合は、「コンテンツ配信をしよう」の「ドメインの取得」セクションの手順を参考に、Route53またはお名前.comなどのレジストラでドメインを取得してください。
2. コンテナ操作について
このセクションでは、APIサーバをECS(Fargate)上のコンテナとして動かします。そのため、ハンズオンの中でDockerを使った以下の操作を行います。
- アプリケーションのコンテナイメージを
docker buildでビルド - ビルドしたイメージをECR(AWSのコンテナレジストリ)に
docker pushでアップロード
コンテナの基本操作に不安がある場合は、「Dockerの基本操作」や「ECR概要」を先に確認しておくとスムーズに進められます。
3. 扱うAWSサービス
前回のハンズオンではVPC・サブネット・セキュリティグループ・EC2の4種類を扱いましたが、今回は本番環境を想定した以下のサービスを組み合わせて構築します。
| レイヤ | AWSサービス | 役割 |
|---|---|---|
| ネットワーク | VPC、サブネット(パブリック/プライベート)、インターネットゲートウェイ、ルートテーブル | マルチAZ対応のネットワーク基盤 |
| アプリケーション | ECS(Fargate)、ECR、ALB | FastAPIコンテナによるAPIサーバ |
| データベース | RDS(MySQL) | プライベートサブネットに配置したデータベース |
| フロントエンド | S3、CloudFront | 静的ファイルのCDN配信 |
| 権限管理 | IAMロール | ECSタスクからAWSサービスへのアクセス権限 |
これらのリソースをモジュールごとに分割し、environments/ディレクトリで環境ごとの設定を分離する構成を採用します。リモートバックエンドでtfstateをS3で管理し、すべてのリソース名には環境名(test)のプレフィックスが付き、test-noteapp-vpcのような命名規則になります。
4. ディレクトリ構成
このセクションで作成するディレクトリ構成は以下のとおりです。modules/ディレクトリにTerraformモジュールを配置し、environments/test/ディレクトリからモジュールを呼び出してインフラを構築します。
terraform-noteapp/
├── modules/
│ ├── remote/ ← コードは自動生成
│ ├── base/
│ │ ├── main.tf
│ │ ├── variables.tf
│ │ └── outputs.tf
│ ├── api/
│ │ ├── main.tf
│ │ ├── variables.tf
│ │ └── outputs.tf
│ └── frontend/
│ ├── main.tf
│ ├── variables.tf
│ └── outputs.tf
├── environments/
│ └── test/
│ ├── backend.tf
│ ├── main.tf
│ ├── variables.tf
│ ├── outputs.tf
│ └── terraform.tfvars
└── app/
└── api/ ← git cloneされたリポジトリ
├── api/
│ ├── Dockerfile
│ ├── main.py
│ ├── models.py
│ ├── database.py
│ ├── requirements.txt
│ └── routers/
│ └── notes.py
└── front/
├── index.html
├── style.css
└── script.js
モジュールは変更頻度とチームの責務を基準に4つに分割しています。
| モジュール | 内容 | 分割の理由 |
|---|---|---|
| remote | S3バケット(tfstate保存)、DynamoDBテーブル(ロック) | tfstate管理のためのリソースで、最初に1回作成した後はほぼ変更しない。アプリケーションのインフラとはライフサイクルが異なる |
| base | VPC、サブネット、IGW、ルートテーブル、セキュリティグループ、RDS、ECR、CloudWatch Logs、Route53ホストゾーン | ネットワークやデータベースなどの基盤リソースは変更頻度が低く、安定稼働後はほぼ触らない |
| api | ECSサービス、タスク定義、ターゲットグループ、ALB、ACM(ALB用)、Route53 Aレコード | APIサーバはアプリケーションの更新やスケーリング変更で比較的頻繁に変更される |
| frontend | S3、CloudFront、ACM(CloudFront用、us-east-1)、Route53レコード | フロントエンドはデプロイ設定の変更やCDN設定の調整で独立して変更される |
| 📝 モジュール分割の考え方 |
|---|
モジュールを分割することで、APIの変更時にVPCやRDSまでplan/applyの対象になることを避けられます。また、インフラチーム・バックエンドチーム・フロントエンドチームがそれぞれの領域だけを管理でき、変更による影響範囲を限定できます。将来environments/prod/のように本番環境を追加する際にも、同じモジュールを再利用できます。 |