02. 標準リポジトリ構成

なぜ構成にこだわるのか

Terraform は .tf ファイルが置かれた ディレクトリ単位 で 1 つの構成（= state）を作ります。dev と prod を同じディレクトリに置くと、片方を直したつもりで両方を壊します。 逆に最初から 環境ごとにディレクトリを分ける 設計にしておくと、dev で試して prod に持っていく流れが自然になります。

最小構成（学習・1 環境用）

my-infra/
├── .gitignore
├── README.md
├── terraform.tf      # terraform { required_version, required_providers, backend }
├── providers.tf      # provider "aws" { ... }
├── variables.tf      # variable "..." { ... }
├── locals.tf         # locals { ... }
├── main.tf           # resource "..." { ... }
└── outputs.tf        # output "..." { ... }

ファイル名は機能ではなく 役割 で分けるのが慣例です。Terraform は同じディレクトリの .tf をすべてマージして読むので、ファイルを分けても動作は同じ。読む人にやさしい分け方を選びます。

標準構成（modules + envs）

my-infra/
├── .github/
│   ├── workflows/
│   │   ├── plan.yml         # PR で plan を回す
│   │   └── apply.yml        # main マージで apply
│   ├── CODEOWNERS           # レビュー必須者
│   └── dependabot.yml       # 依存更新（任意）
├── .gitignore
├── .pre-commit-config.yaml  # commit 前に fmt/validate
├── README.md
│
├── modules/                 # 再利用可能な部品
│   ├── network/
│   │   ├── main.tf
│   │   ├── variables.tf
│   │   ├── outputs.tf
│   │   └── README.md        # ← README があるものだけ「外部公開可」
│   ├── compute/
│   └── storage/
│
└── envs/                    # 環境ごと（= state ごと）
    ├── dev/
    │   ├── main.tf          # module "network" { source = "../../modules/network" }
    │   ├── terraform.tfvars # この環境固有の変数値
    │   └── backend.tf       # この環境用 state の保存先
    ├── stg/
    └── prd/

envs ディレクトリのねらい

• 各環境が 別の state ファイル を持つ。dev で apply しても prd は触らない
• 環境固有の値（インスタンスサイズ、CIDR 等）は terraform.tfvars に切り出す
• 各環境の main.tf は modules/* を呼び出すだけ の薄いコードにする

環境分離に Workspace は使わない

モジュール内の標準ファイル

各モジュールは「最低限これだけ」のセットが推奨です。

modules/network/
├── main.tf       # resource ブロック群（このモジュールが作るもの）
├── variables.tf  # 入力（呼び出し元が渡す値）
├── outputs.tf    # 出力（呼び出し元に返す値）
└── README.md     # 何のためのモジュールか・使い方

呼び出し側はこうなります:

module "network" {
  source = "../../modules/network"

  vpc_cidr           = "10.10.0.0/16"
  public_subnet_cidrs = ["10.10.1.0/24", "10.10.2.0/24"]
}

# モジュールの output は module.<name>.<output_name> で参照
resource "aws_instance" "web" {
  subnet_id = module.network.public_subnet_ids[0]
  # ...
}

よくあるアンチパターン