今回作る構成

「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/のように本番環境を追加する際にも、同じモジュールを再利用できます。