1. Terraformモジュールとは

まず、Terraformモジュールとは複数のリソース定義をひとまとめにして再利用可能にしたコードの塊です。例えば「VPC＋サブネット＋ルートテーブル」のセットをモジュールとして定義することで、dev・stg・prodの各環境で呼び出すだけで同じ構成を展開できます。

2. モジュールのディレクトリ構成

infra/
├── modules/
│   ├── vpc/
│   │   ├── main.tf
│   │   ├── variables.tf
│   │   └── outputs.tf
│   └── ec2/
│       ├── main.tf
│       ├── variables.tf
│       └── outputs.tf
└── environments/
    ├── dev/
    │   └── main.tf  # modules/vpcを呼び出す
    └── prod/
        └── main.tf  # 同じmodules/vpcを呼び出す

3. モジュールの呼び出し方

# environments/prod/main.tf
module "vpc" {
  source = "../../modules/vpc"

  vpc_cidr    = "10.0.0.0/16"
  environment = "prod"
  region      = "ap-northeast-1"
}

# modulesのoutputsを参照
output "vpc_id" {
  value = module.vpc.vpc_id
}

4. リモートステート管理（S3バックエンド）

• S3バケットにtfstateを保管：チームでTerraformを使う場合はtfstateをS3に保存して共有する
• DynamoDBでステートロック：複数人が同時にterraform applyしないようDynamoDBでロックを管理
• 環境別にS3プレフィックスを分離：s3://mybucket/dev/terraform.tfstate・s3://mybucket/prod/terraform.tfstateのように環境別に分ける

terraform {
  backend "s3" {
    bucket         = "my-terraform-state"
    key            = "prod/terraform.tfstate"
    region         = "ap-northeast-1"
    dynamodb_table = "terraform-lock"
  }
}

よくある質問（FAQ）