モジュールによる環境別管理

ここまでのハンズオンで、モジュールを使ってS3バケットを1つ作成しました。しかし、モジュールの本当の便利さは同じモジュールを使い回せるところにあります。

実際の開発では、「テスト環境」と「本番環境」のように、同じ構成のインフラを複数用意することがよくあります。例えば、新しい機能を開発するときは、まずテスト環境で動作確認をしてから本番環境にリリースします。このとき、テスト環境と本番環境のインフラ構成は基本的に同じですが、リソース名やサイズなどの設定値だけが異なります。

モジュールを使わない場合、同じコードをコピーして名前だけ書き換えることになり、修正が必要になったときに両方を変更しなければなりません。モジュールを使えば、コードは1つだけ管理し、呼び出す時に渡す値を変えるだけで複数の環境を作れます。

1. VPCを環境ごとに分ける例

例えば、VPCモジュールにnameとvpc_cidrを変数として定義しておけば、テスト環境と本番環境でVPC名とIPアドレス範囲を分けて作成できます。

# テスト環境
module "test_vpc" {
  source   = "./modules/vpc"
  name     = "test-vpc"
  vpc_cidr = "10.0.0.0/16"
}

# 本番環境
module "prod_vpc" {
  source   = "./modules/vpc"
  name     = "prod-vpc"
  vpc_cidr = "10.1.0.0/16"
}

テスト環境と本番環境で同じ構成のVPCが作られますが、名前はtest-vpcとprod-vpc、CIDRブロックは10.0.0.0/16と10.1.0.0/16のように異なる値が設定されます。VPCモジュールの中身(サブネットの分割方法やルートテーブルの設定など)は共通のコードが使われるため、構成のばらつきが起きません。

2. 環境別ディレクトリ構成

ここまでの例では1つのmain.tfの中でテスト用と本番用のモジュールを呼び出していましたが、実際にはさらに進んで、環境ごとにディレクトリを分ける構成が一般的です。

プロジェクト/
├── modules/
│   └── vpc/
│       ├── main.tf
│       ├── variables.tf
│       └── outputs.tf
└── environments/
    ├── test/          ← テスト環境用
    │   └── main.tf
    └── prod/          ← 本番環境用
        └── main.tf

environments/test/main.tfとenvironments/prod/main.tfはどちらも同じmodules/vpcを呼び出しますが、渡す値が異なります。テスト環境を操作したいときはenvironments/test/ディレクトリに移動してterraform applyを実行し、本番環境を操作したいときはenvironments/prod/に移動して実行します。

📝 なぜ modules/ 自体をルートモジュールにしないのか
モジュールは「他から呼び出されて使われること」を前提に設計されたコードです。source 引数で指定されて初めて機能するため、modules/vpc/ に直接移動して terraform apply しても正しく動きません。ルートモジュール(terraform apply を実行するディレクトリ)は、必ずモジュールを呼び出す側である必要があります。そのため、本セクションでは environments/test/ や environments/prod/ をルートモジュールとし、そこから modules/vpc/ を呼び出す構成を採用しています。

さらに、テスト環境と本番環境でAWSアカウント自体を分けることも実際にはよく行われます。テスト環境の操作ミスが本番環境に影響しないよう、AWSアカウントを完全に分離するためです。この場合、environments/test/で作業するときはテスト用のAWSアカウントの認証情報を、environments/prod/で作業するときは本番用のAWSアカウントの認証情報を使うことで、同じモジュールを別々のアカウントにデプロイできます。

💡 ポイント
環境のディレクトリ分割やアカウント分離は、ここでは無理に試す必要はありません。「モジュールを使うと、こういう構成ができるんだな」という参考程度に把握しておいてください。後のハンズオン「TerraformでWebアプリケーションをデプロイしよう」で、この構成を実際に体験します。

3. リソースの削除

確認が終わったら、作成したリソースを削除しておきましょう。

terraform destroy