現場実践｜IaC上級テクニック

Terraformモジュール化の実践｜再利用可能なインフラコードの設計と管理

「Terraformのコードが長くなってきた」「同じ構成を複数環境に展開したい」——Terraformのモジュール化・ワークスペース・リモートステート管理を実践的に解説します。

読了目安：約18分更新日：2026年3月

💡 Terraformモジュール化は「コピペ地獄」からの脱却手段。1度書いたモジュールをdev・stg・prodで使い回すことで、環境間の設定差異を最小化しIaCの品質が向上します。

この記事を書いた人

現役ITエンジニア・IT講師（経験14年）

CCNA・CCNP 取得LPIC-1 保有SES現場を複数経験

複数のTerraformプロジェクトのモジュール設計・リファクタリングを担当してきた立場から解説します。

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"
  }
}

📌 この記事のポイント