Terraformのmoduleとfor_each・countで構成を再利用する設計パターン

運営:リナックスマスター.JP(代表 宮崎智広)
HOME > Linux技術 リナックスマスター.JP(Linuxマスター.JP) > Ansible > Terraformのmoduleとfor_each・countで構成を再利用する設計パターン
「Terraformコードが増えるにつれて、似たようなリソース定義があちこちにコピーされてしまう」
「for_eachとcountはどう使い分ければいいのか。リストの途中を変更したら、意図しないリソースが破棄されてしまった」
Terraformを使い始めると、最初はうまくいきます。VPCを作り、EC2を作り、サブネットを定義する。しかし3つ目、4つ目の環境を作り始めたとき、コードが爆発的に膨らんでいることに気づきます。

workspace機能や-var-fileで環境を分けるアプローチも有効ですが、S3バックエンドのバケット名・DynamoDBテーブル名を環境ごとに切り替える記述が煩雑になりやすく、コードの三重管理という根本的な問題は解消しません。

この記事では、terraform moduleの使い方と、for_each・countを組み合わせた構成の再利用設計パターンを解説します。
moduleの基本構造から、countとfor_eachの使い分け基準(インデックスずれによるリソース破棄リスクを含む)、localsブロックを使った環境設定の一元管理、dynamic blockの活用、movedブロックを使った安全な移行手順、よくあるトラブルの対処まで、実務で通用するパターンを段階的に説明します。for式とsplat式を使ったリソース属性のリスト・マップ変換パターンも合わせて解説します。想定環境はTerraform 1.1以降です。

この記事のポイント

・terraform moduleでリソース定義を再利用可能な単位にまとめられる
・countはインデックス(数値)でリソースを識別するため途中削除でずれが起きる
・for_eachはキー名(文字列)で管理するため途中追加・削除しても影響が限定される
・for_eachのキーは後から変えられない設計判断で、論理名(役割名)を選ぶのが原則
・countからfor_eachへの移行はmovedブロックでリソースを壊さずstateキーを書き換えられる
・dynamic blockでfor_eachを使うとリソース内のブロックを宣言的に管理できる
・for式は[for x in list : 変換式]でリスト・マップを動的に変換できる
・splat式 resource[*].id でcountリソースの属性一覧を1行で取得できる


「このままじゃマズい」と感じていませんか?
参考書を開く気力もない、同年代に取り残される不安——
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

なぜterraform moduleが必要なのか

Terraformを書き始めたエンジニアが最初にぶつかる壁は「コードの重複」です。
開発環境と本番環境、dev・staging・prodの3環境、TokyoとOsakaの複数リージョンなど、似た構成を複数作ろうとすると、コピー&ペーストしかないのかという疑問が生まれます。

その答えがmoduleです。Terraformのmoduleとは、関連するリソース定義をひとまとまりにして「部品」として扱えるようにする仕組みです。プログラミングでいう関数に近い概念で、引数(input variables)と戻り値(outputs)を持ち、何度でも呼び出せます。

Terraform標準のworkspace機能や-var-fileによる環境分離も有効な手段ですが、限界があります。S3バックエンドのバケット名やDynamoDBのロックテーブル名を環境ごとに切り替えようとすると、backend設定ブロックは変数を受け付けません。

そのため、環境数だけバックエンド設定を手書きするか、外部スクリプトを使わざるを得なくなります。moduleを使うと、環境差分をinputとして渡す設計ができ、コードの重複を構造的に排除できます。

moduleを使わない場合、EC2+SecurityGroup+EIPのセットを3環境分作ると、ほぼ同じコードが3箇所に存在します。moduleを使えば、同じセットを1箇所に定義して3回呼び出すだけになります。

・変更が1箇所で済む(保守性向上)
・テスト済みの定義を使い回せる(品質安定)
・環境ごとの差分が変数だけになる(差分管理の明確化)

moduleの基本構造とディレクトリ設計

1. ディレクトリ構造の基本

moduleはディレクトリ=1moduleが基本の設計思想です。以下が一般的なディレクトリ構成です。

# プロジェクトルート構成 . ├── main.tf # ルートモジュール(moduleを呼び出す側) ├── variables.tf ├── outputs.tf └── modules/ ├── ec2/ # EC2モジュール │ ├── main.tf │ ├── variables.tf │ └── outputs.tf └── vpc/ # VPCモジュール ├── main.tf ├── variables.tf └── outputs.tf

呼び出し側(ルートモジュール)の main.tf でmoduleブロックを使います。

# ルートのmain.tf module "web_server" { source = "./modules/ec2" instance_type = "t3.micro" ami_id = "ami-0c7217cdde317cfec" name = "web" } module "app_server" { source = "./modules/ec2" instance_type = "t3.small" ami_id = "ami-0c7217cdde317cfec" name = "app" }

同じmodule(./modules/ec2)を2回呼び出しています。それぞれ異なる引数を渡すことで、別々のEC2インスタンスが作られます。

terraform initの再実行が必要なタイミング

moduleのsourceを新たに追加・変更した後は必ず terraform init を再実行してください。initを忘れると「Module not installed」エラーが出て、planもapplyも実行できません。新しいメンバーがリポジトリをクローンした場合も同様です。GitHubやTerraform Registryからmoduleをダウンロードする場合も変わりません。

# moduleのsourceを変更・追加した後は必ずinitを再実行する $ terraform init # エラーが出た場合は -upgrade フラグで強制更新できる $ terraform init -upgrade

2. moduleの内側(variables.tf / outputs.tf)

modules/ec2/variables.tf でmoduleが受け取る引数を定義します。

# modules/ec2/variables.tf variable "instance_type" { description = "EC2インスタンスタイプ" type = string default = "t3.micro" } variable "ami_id" { description = "AMI ID" type = string } variable "name" { description = "リソース名(Nameタグに使用)" type = string }

modules/ec2/outputs.tf では、呼び出し元が参照できる値を定義します。

# modules/ec2/outputs.tf output "instance_id" { value = aws_instance.this.id } output "private_ip" { value = aws_instance.this.private_ip }

呼び出し元では module.web_server.instance_id のように参照できます。

countによる繰り返し

3. countの基本

同じリソースを指定した個数だけ作りたい場合はcountを使います。最もシンプルな繰り返し方法です。

Terraformはすべてのリソースをstateファイル(terraform.tfstate)で管理しています。stateには「どのリソースが存在するか」がキーと値のペアで記録されており、terraform planはstateと実際のクラウドリソースを比較して差分を計算します。

countを使うと、リソースはインデックス番号(0、1、2と続く番号)でstateに記録されます。この「数値の位置でリソースを管理する」設計が、後述するインデックスずれ問題の根本原因になります。

# 3台のEC2インスタンスを作る例 resource "aws_instance" "worker" { count = 3 ami = "ami-0c7217cdde317cfec" instance_type = "t3.micro" tags = { Name = "worker-${count.index}" # worker-0, worker-1, worker-2 } }

count.index には 0 から始まる通し番号が入ります。aws_instance.worker[0] aws_instance.worker[1] のようにインデックスでアクセスできます。

変数から個数を制御する使い方もよく使われます。

variable "worker_count" { type = number default = 3 } resource "aws_instance" "worker" { count = var.worker_count ami = "ami-0c7217cdde317cfec" instance_type = "t3.micro" tags = { Name = "worker-${count.index}" } }

countで作成されたリソースはstate内で数値インデックス付きのアドレスで管理されます。terraform state listで確認すると以下のようになります。

$ terraform state list aws_instance.worker[0] aws_instance.worker[1] aws_instance.worker[2]

このアドレス形式が、後述するインデックスずれ問題の根本原因です。リソースが数値の「位置」で識別されるため、途中の要素がなくなると後続の位置がずれます。

4. countのインデックスずれ問題

countには大きな落とし穴があります。リストの途中の要素を削除したとき、インデックスがずれて既存リソースが予期せず破棄・再作成されることです。

たとえば ["web-01", "web-02", "web-03"] のリストで3台作成した後、「web-02」を削除してリストが ["web-01", "web-03"] になったとします。Terraformはstate内の web[1] が「web-03」に変わったと解釈して、既存の web[1](web-02)を破棄してから web[1](web-03)として再作成しようとします。さらに web[2](web-03)も「参照がなくなった」として削除されます。

実際にterraform planを実行すると以下のような出力になります。

# リスト変更後のterraform plan出力(抜粋) # aws_instance.web[1] will be destroyed - resource "aws_instance" "web" { - tags = { "Name" = "web-02" -> null } } # aws_instance.web[1] will be created + resource "aws_instance" "web" { + tags = { "Name" = "web-03" } } # aws_instance.web[2] will be destroyed - resource "aws_instance" "web" { - tags = { "Name" = "web-03" -> null } } Plan: 1 to add, 0 to change, 2 to destroy.

リストから1要素を削除しただけで、2台が破棄される計画が立てられました。本番環境ではサービス断につながる致命的な問題です。

サブネットのCIDRリストを例にすると、この問題はさらに深刻になります。先頭要素を1つ削除しただけで、残るリソース全体が「差し替え」扱いになります。

# 変更前 variable "subnet_cidrs" { type = list(string) default = ["10.0.1.0/24", "10.0.2.0/24", "10.0.3.0/24"] } # 変更後(先頭の "10.0.1.0/24" を削除) variable "subnet_cidrs" { type = list(string) default = ["10.0.2.0/24", "10.0.3.0/24"] }

# terraform plan の出力(意図は1削除だが実際は全件に影響) # aws_subnet.example[0] must be replaced -/+ resource "aws_subnet" "example" { ~ cidr_block = "10.0.1.0/24" -> "10.0.2.0/24" # forces replacement } # aws_subnet.example[1] must be replaced -/+ resource "aws_subnet" "example" { ~ cidr_block = "10.0.2.0/24" -> "10.0.3.0/24" # forces replacement } # aws_subnet.example[2] will be destroyed - resource "aws_subnet" "example" { cidr_block = "10.0.3.0/24" } Plan: 2 to add, 0 to change, 3 to destroy.

削除したいのは 10.0.1.0/24 の1サブネットだけなのに、3件destroy・2件add という破壊的なplanになっています。既存のサブネットにEC2インスタンスやENIが紐づいていれば、applyはVPC依存関係エラーで途中停止し、部分的に壊れたtfstateが残ることもあります。

名前付きリストを使うケースでも同様の問題が起きます。サーバー名 ["web-a", "web-b", "web-c"] から "web-b" を削除しようとした場合、Terraformはインデックス[1]のリソースを「Nameタグを web-b から web-c にインプレース更新」して、インデックス[2]のリソース(本来の web-c)を「削除」する計画を立てます。

# 変更前: 名前のリストを参照してcountで3台作成 variable "server_names" { type = list(string) default = ["web-a", "web-b", "web-c"] } resource "aws_instance" "web" { count = length(var.server_names) ami = "ami-0c7217cdde317cfec" instance_type = "t3.micro" tags = { Name = var.server_names[count.index] } } # 変更後: "web-b" を削除したつもりで ["web-a", "web-c"] に変更 variable "server_names" { type = list(string) default = ["web-a", "web-c"] }

# terraform plan の出力例(環境により異なります) # aws_instance.web[1] will be updated in-place ~ resource "aws_instance" "web" { ~ tags = { ~ "Name" = "web-b" -> "web-c" # 本来の web-c インスタンスに上書き } } # aws_instance.web[2] will be destroyed - resource "aws_instance" "web" { - tags = { "Name" = "web-c" } # 本来の web-c が削除される } Plan: 0 to add, 1 to change, 1 to destroy.

「インプレース更新 + 削除」という形ですが、結果は同じです。残したかった "web-c" のEC2インスタンスが一度破棄されて再作成されることになります。プライベートIPアドレスが変わり、DNS登録が無効になり、関連リソースへの更新が本番環境では必要になります。

IAMユーザーのようにインプレース更新できないリソース(name変更が -/+ の再作成になる)ではこの問題がより深刻です。たとえば alice・bob・carol の3人をcountで管理していて bob を削除しようとすると、Terraformはインデックス[1]を「bob→carolに変更(再作成)」、インデックス[2]を「削除」と解釈します。

意図は「bobだけ削除」なのに、carolのアクセスキー・インラインポリシー・グループ所属が一時的に失われます。自動applyが走るCIパイプラインではこの破壊的な差分が無人で実行されるため特に危険です。

# countを使ったIAMユーザー定義 variable "users" { default = ["alice", "bob", "carol"] } resource "aws_iam_user" "example" { count = length(var.users) name = var.users[count.index] } # stateのリソースアドレス(確認方法: terraform state list) aws_iam_user.example[0] # alice aws_iam_user.example[1] # bob aws_iam_user.example[2] # carol # "bob" を削除して ["alice", "carol"] にしたときのplan出力例 # aws_iam_user.example[1] will be destroyed → bob を削除 # aws_iam_user.example[1] will be updated in-place # ~ name = "bob" -> "carol" → carolが[1]に移動して更新 # aws_iam_user.example[2] will be destroyed → 本来のcarolが削除される Plan: 0 to add, 1 to change, 2 to destroy.

削除したいのはbobだけなのに、carolのリソースも破棄・再作成される計画になります。

planで「想定外のdestroyやforces replacement」を素早く確認する

countを使ったリソースに変更を加えるときは、terraform planの出力にある destroy や forces replacement の件数に注目してください。想定より多い件数が出ていれば、インデックスずれによる意図しない操作が発生しているサインです。以下のコマンドで素早く絞り込めます。

# destroy や再作成が発生しているか素早く確認するコマンド例 terraform plan | grep -E "destroy|forces replacement"

本番変更前には terraform plan -out=tfplan でプランをファイルに保存し、内容を十分に確認した上で terraform apply tfplan を実行する習慣をつけてください。

countを使ってよい場面: リストが固定で中間削除が起きない場合。代表例は「0か1かの条件フラグ」で、count = var.enable_nat ? 1 : 0 のようにリソースのon/offを切り替えるパターンです。このパターンではインデックスは常に0か存在しないかで安定します。NATゲートウェイの2台構成(コスト削減モードで1台、本番で2台)のように設定が全台同一で末尾の増減しか起きない場合もcountが適しています。

countを使うべきでない場面: サブネット・セキュリティグループ・IAMユーザーなど、要素が増減する可能性があるリソースセット。後からリスト中間の要素を削除・追加することがあれば、最初からfor_eachを使う設計にします。

5. countをmoduleに適用する

moduleブロックにも count を指定できます。

module "web_server" { count = 3 source = "./modules/ec2" instance_type = "t3.micro" ami_id = "ami-0c7217cdde317cfec" name = "web-${count.index}" } # 参照はインデックスで行う output "web_server_ids" { value = module.web_server[*].instance_id }

[*] はスプラット式で、全インデックスの値をリストとして取得できます。moduleにcountを使う場合もインデックスずれ問題は同様に発生するため、各サーバーに意味のある名前がある場合はfor_eachを選ぶほうが安全です。

splat式でcountリソースの属性を一括取得する

countで作ったリソースの属性をまとめて取得したいとき、[*](スプラット演算子)を使うとID一覧を1行で書けます。サブネットIDをEKSモジュールに渡すケースが典型例です。

resource "aws_subnet" "private" { count = 3 vpc_id = aws_vpc.main.id cidr_block = "10.0.${count.index + 1}.0/24" availability_zone = data.aws_availability_zones.available.names[count.index] } # splat式でサブネットIDのリストを一括取得 output "private_subnet_ids" { value = aws_subnet.private[*].id } # 出力例(環境により異なります): # ["subnet-0abc1234", "subnet-0def5678", "subnet-0ghi9012"]

aws_subnet.private[*].id は [for s in aws_subnet.private : s.id] の短縮形です。countリソース限定の省略記法で、可読性が高く慣例的によく使われます。

for_eachリソースにsplat式は使えません

for_each で作ったリソースに [*] を使うとエラーになります。代わりにfor式か、values() 関数でリスト化してから使う方法を取ります。

resource "aws_subnet" "private" { for_each = toset(["web", "app", "db"]) vpc_id = aws_vpc.main.id # ... } # NG: for_eachリソースにsplat式は使えない # aws_subnet.private[*].id <- エラー # OK1: for式を使う(順序が重要な場合はこちら) output "private_subnet_ids" { value = [for s in aws_subnet.private : s.id] } # OK2: values()でリスト化してからsplat式を使う output "private_subnet_ids_v2" { value = values(aws_subnet.private)[*].id }

values(aws_subnet.private) でリソースマップのバリュー部分をリストに変換することで、splat式が使えるようになります。ただしfor_eachのキー順は保証されないため、順序が重要な場合はfor式を使う方が確実です。

モジュール間でリストを受け渡す際は、受け取り側のvariableに type = list(string) を明示することでplan時の型エラーを早期に検出できます。

# modules/vpc/outputs.tf output "private_subnet_ids" { value = aws_subnet.private[*].id # countリソースのsplat式 } # root/main.tf module "vpc" { source = "./modules/vpc" # ... } module "eks" { source = "./modules/eks" subnet_ids = module.vpc.private_subnet_ids # list(string) 型で渡る }

for_eachによる繰り返し

6. for_eachの基本(setとmapの使い分け)

for_each はマップ(map)またはセット(set)を使って繰り返します。各要素に意味のある名前(キー)をつけられることが特徴で、countと違いインデックスではなく文字列キーでリソースを識別します。

Stateに記録される識別キーが文字列になることが重要な点です。リストの並び順が変わっても、キー名が変わらない限り他のリソースに影響を与えません。

set型(名前のリストがある場合)

variable "instance_names" { type = set(string) default = ["web-01", "web-02", "web-03"] } resource "aws_instance" "web" { for_each = var.instance_names ami = "ami-0c7217cdde317cfec" instance_type = "t3.micro" tags = { Name = each.key # "web-01", "web-02", "web-03" } }

for_eachで作成されたリソースはstate内で文字列キーで識別されます。terraform state listで確認すると、countとは異なりキー名がそのままアドレスになっていることがわかります。

$ terraform state list aws_instance.web["web-01"] aws_instance.web["web-02"] aws_instance.web["web-03"]

「web-02」を削除しても、Terraformは aws_instance.web["web-01"] と aws_instance.web["web-03"] が引き続き存在することを認識します。破棄されるのは aws_instance.web["web-02"] だけです。これがcountと根本的に異なる点で、IAMユーザーのようにインプレース更新できないリソースでも「削除対象だけ」に変更を絞り込めます。

先ほどのIAMユーザーの例でfor_eachを使うと、動作がまったく変わります。

# for_eachを使ったIAMユーザー定義 resource "aws_iam_user" "example" { for_each = toset(var.users) name = each.value } # stateのリソースアドレス aws_iam_user.example["alice"] aws_iam_user.example["bob"] aws_iam_user.example["carol"] # "bob" を削除したときのplan出力例(環境により異なります) # aws_iam_user.example["bob"] will be destroyed # - name = "bob" Plan: 0 to add, 0 to change, 1 to destroy.

削除されるのは ["bob"] だけです。aliceとcarolには変更が発生しません。文字列キーでリソースを識別するため、リストの並び順が変わっても他のリソースに影響しない設計になっています。

map型(各要素に複数の属性を持たせる場合)

variable "servers" { type = map(object({ instance_type = string ami_id = string })) default = { "web" = { instance_type = "t3.micro" ami_id = "ami-0c7217cdde317cfec" } "app" = { instance_type = "t3.small" ami_id = "ami-0c7217cdde317cfec" } "db" = { instance_type = "t3.medium" ami_id = "ami-0c7217cdde317cfec" } } } resource "aws_instance" "servers" { for_each = var.servers ami = each.value.ami_id instance_type = each.value.instance_type tags = { Name = each.key # "web", "app", "db" } }

each.key でキー名("web"など)、each.value で対応する値にアクセスできます。リソースIDは aws_instance.servers["web"] のように文字列キーで参照します。各要素に異なる設定値を持たせたい場合、countではインデックスに対して個別の値を対応付けるのが難しく、マップを使うfor_eachが自然に表現できます。

for_eachリソースを別のリソースから参照するパターン

for_eachで作成したリソースを別のリソースから参照するとき、そのリソース自体をfor_eachの値として直接渡すことができます。ロードバランサーのターゲットグループ登録がその典型例です。

resource "aws_instance" "web" { for_each = toset(["web-a", "web-b", "web-c"]) ami = "ami-0c7217cdde317cfec" instance_type = "t3.micro" tags = { Name = each.key } } # aws_instance.web 全体を for_each に渡すことができる resource "aws_lb_target_group_attachment" "web" { for_each = aws_instance.web # for_each リソースをそのまま渡す target_group_arn = aws_lb_target_group.app.arn target_id = each.value.id # インスタンスID port = 80 }

for_each = aws_instance.web と書くことで、aws_instance.web の全リソースに対して自動的にアタッチメントが作成されます。インスタンスを追加・削除しても、アタッチメント側は自動で追従します。each.key はインスタンスのfor_eachキー("web-a"など)、each.value はインスタンスオブジェクト全体なので each.value.id でインスタンスIDを参照できます。

for_eachで全IDをリストとして出力する場合は、splat式は使えないためfor式を使います(「splat式でcountリソースの属性を一括取得する」節参照)。

# for_each リソースの全IDをリストで出力する output "web_instance_ids" { value = [for instance in aws_instance.web : instance.id] }

7. for_eachをmoduleに適用する

for_each はmoduleブロックにも使えます。環境(dev/staging/prod)ごとに構成を変えたいときに特に便利です。インスタンスタイプだけでなく、台数やDBクラスなど複数のパラメータをまとめて管理できます。

locals { environments = { dev = { instance_type = "t3.micro" min_size = 1 max_size = 2 db_instance_class = "db.t3.micro" } staging = { instance_type = "t3.small" min_size = 1 max_size = 3 db_instance_class = "db.t3.small" } prod = { instance_type = "t3.large" min_size = 3 max_size = 10 db_instance_class = "db.m5.large" } } } module "env" { for_each = local.environments source = "./modules/app-env" env_name = each.key instance_type = each.value.instance_type min_size = each.value.min_size max_size = each.value.max_size db_instance_class = each.value.db_instance_class } # 環境ごとのURLを出力する例 output "env_urls" { value = { for k, v in module.env : k => v.app_url } }

環境ごとに複数のパラメータがあっても、localsのマップに集約しておけばfor_eachで一気に展開できます。どの環境にどのスペックを使うかが1箇所で把握できる点が実務上の大きなメリットです。countでmoduleを呼び出す場合もインデックスずれ問題は同様に起きるため、環境名などの意味のある識別子が使えるケースでは、モジュール呼び出しもfor_eachを選ぶのが安全です。

安定したキーの選び方

for_eachのキー選びは、後から変更できないという点で重要な設計判断です。一度作成したリソースのキーを変えると、Terraformはその変更を「削除して再作成」と解釈します。

良いキーの例: リソースの論理名("web-server"・"db-primary"・"cache-main")、環境識別子("prod"・"stg"・"dev")、不変の識別子(AWSリソースのNameタグ値など)

避けるべきキーの例: 自動採番された連番(結局countと同じ問題になる)、後で変わり得るIPアドレスやARN(変わった瞬間に再作成が走る)

特に注意が必要なのは、AWS ARNをキーに使うケースです。リソースを削除して作り直すと新しいARNになるため、そのARNをキーにしている別リソースが連鎖的に再作成されます。人間が読んで変わらない論理名をキーにするのが原則です。

for式・条件フィルタリングの応用

HCLのfor式はリストやマップを変換・フィルタリングして新しいコレクションを返す汎用構文です。for_eachに渡す前の前処理としても使えますが、outputやlocalsでリソース属性を整形する場面でも活躍します。

リストからリストを生成する

[for 変数 in コレクション : 変換式] の形で、各要素に処理を加えた新しいリストを作れます。

variable "subnet_names" { type = list(string) default = ["web", "app", "db"] } locals { # 環境プレフィックスを付けた名前リストを生成 prefixed_names = [for name in var.subnet_names : "prod-${name}"] } # 出力例(環境により異なります): # ["prod-web", "prod-app", "prod-db"]

リストからマップを生成する

{} 形式を使うと、リストからマップを作れます。サブネット名をキー、CIDRをバリューにするケースが典型例です。

variable "subnets" { type = list(object({ name = string cidr = string })) default = [ { name = "web", cidr = "10.0.1.0/24" }, { name = "app", cidr = "10.0.2.0/24" }, ] } locals { # サブネット名をキー、CIDRをバリューにしたマップを生成 subnet_map = { for s in var.subnets : s.name => s.cidr } } # 出力例(環境により異なります): # { web = "10.0.1.0/24", app = "10.0.2.0/24" }

マップのキーは一意でなければなりません。重複キーが生成されるとplan時に「Duplicate object key」エラーになります。キーが重複する可能性がある場合は ...(省略記号)を使ったグループ集約形式にすると、同一キーの値をリストにまとめられます。

# NG: envが重複するとplan時にエラー locals { bad_map = { for s in var.subnets : s.env => s.cidr } } # OK: グループ集約形式(同一キーの値をリストにまとめる) locals { grouped = { for s in var.subnets : s.env => s.cidr... } } # 出力例(環境により異なります): # { dev = ["10.0.1.0/24", "10.0.2.0/24"], prod = ["10.1.1.0/24"] }

if句で条件フィルタリングする

for_eachに渡す前にマップをフィルタリングしたい場合もfor式を使います。特定のリソースを一時的に「無効化」したいときに便利なパターンです。

# enable フラグを追加したオブジェクト型 variable "instances" { type = map(object({ instance_type = string ami = string enable = bool })) default = { "web" = { instance_type = "t3.small" ami = "ami-0c7217cdde317cfec" enable = true } "worker" = { instance_type = "c5.xlarge" ami = "ami-0c7217cdde317cfec" enable = false # 一時的に無効化 } } } locals { # enable = true のものだけを抽出(for式によるフィルタリング) enabled_instances = { for k, v in var.instances : k => v if v.enable } } resource "aws_instance" "app" { for_each = local.enabled_instances ami = each.value.ami instance_type = each.value.instance_type tags = { Name = each.key } }

enable = false に設定するだけでリソース定義を削除せずに無効化できます。Gitの変更履歴が残るため、「なぜそのインスタンスを止めたか」が後から追跡できます。count = 0への書き換えより意図が明確で、コードレビュー時に差分の意味がわかりやすくなります。

countとfor_eachの使い分け判断基準

どちらを使うべきか迷うことが多いです。以下の基準で判断してください。
状況 推奨 理由
数だけ決まっていて、個々に意味がない count シンプルに書ける
各要素に意味のある名前がある for_each リソース管理がキー名で明確になる
途中の要素を削除する可能性がある for_each インデックスがずれないため安全
設定に個体差があるリソース for_each マップ変数で自然に各要素へ異なる値を持たせられる
マップ/セット型の変数がある for_each 変数の構造をそのまま活用できる
dev・staging・prodなど環境ごとの設定がある for_each localsマップと組み合わせて一元管理できる
シンプルな同種リソースのコピー count コードが短くなる
リソースを「作る・作らない」を切り替えたい count = 条件 ? 1 : 0 0か1の切り替えならインデックスずれなし
terraform state listで人間が読める形で管理したい for_each 文字列キーで意味のあるアドレスになる
countの落とし穴:インデックスのずれ問題

count で3台([0][1][2])作った後、[1]を削除したとします。Terraformはインデックスを詰め直すため、[2]だったリソースが[1]になり、既存リソースが「削除して再作成」と判断されることがあります。

for_each の場合はキー名で管理するため、ひとつのキーを削除しても他のリソースには影響しません。これが「変更が多い構成にはfor_each」と言われる主な理由です。

「0か1か」の条件制御はcountが得意

countが最も適しているのは、リソースを作る・作らないを条件で切り替えるパターンです。

# NATゲートウェイを作る・作らないを変数で切り替える例 resource "aws_eip" "nat" { count = var.create_nat ? 1 : 0 domain = "vpc" }

このパターンは要素が常に0個か1個のため、インデックスずれの心配がありません。迷ったらfor_eachを選んでよいですが、「0か1か」の条件制御はcountが自然に書ける場面として覚えておくとよいです。

実践的なmodule設計パターン

8. ネストmodule(moduleからmoduleを呼ぶ)

moduleの中からさらに別のmoduleを呼び出すことができます。ネストmoduleと呼びます。

# modules/app-env/main.tf # このmodule内でvpcモジュールを呼び出す module "vpc" { source = "../vpc" cidr_block = var.vpc_cidr env_name = var.env_name } module "ec2" { source = "../ec2" subnet_id = module.vpc.public_subnet_id instance_type = var.instance_type name = "${var.env_name}-app" }

ネストmoduleのポイントは、moduleのoutputを別のmoduleのinputとして渡せることです。上の例では、vpcモジュールが出力する public_subnet_id をec2モジュールの subnet_id に渡しています。

9. 入力変数の型定義を丁寧に書く

moduleの品質は入力変数(variables.tf)の設計で決まると言っても過言ではありません。型を明確にし、descriptionを書き、validationを追加するとmoduleの使いやすさが格段に上がります。

# modules/ec2/variables.tf (丁寧な定義の例) variable "instance_type" { description = "EC2インスタンスタイプ(t3.micro / t3.small / t3.medium)" type = string default = "t3.micro" validation { condition = contains(["t3.micro", "t3.small", "t3.medium", "t3.large"], var.instance_type) error_message = "許可されるインスタンスタイプ: t3.micro, t3.small, t3.medium, t3.large" } } variable "tags" { description = "リソースに付与するタグのマップ" type = map(string) default = {} }

validationブロックを入れることで、不正な値が渡された場合に terraform plan 時点でエラーとして検出できます。実行時のエラーより格段に早い段階で問題を発見できます。

10. outputの設計(必要な値だけ外に出す)

outputは「moduleの外から何を参照できるか」を定義します。すべての値を外に出す必要はありません。呼び出し元が実際に使う値に絞ることで、moduleのインターフェースがシンプルになります。

# modules/ec2/outputs.tf output "instance_id" { description = "EC2インスタンスID" value = aws_instance.this.id } output "private_ip" { description = "プライベートIPアドレス" value = aws_instance.this.private_ip } # sensitive=trueで機密値をplan/applyの出力に表示させない output "connection_string" { description = "DB接続文字列(機密)" value = local.db_connection_string sensitive = true }

11. localsブロックで環境設定を一元管理する

for_eachでmoduleを複数環境に展開するとき、インスタンスタイプ・台数・DBクラスなどの環境差分がコードのあちこちに散らばりやすいです。localsブロックに環境設定マップを一箇所に集約することで、「どの環境にどのスペックを使うか」を一目で把握できるようになります。

# locals.tf: 環境設定をマップで一元管理する locals { env_config = { dev = { instance_type = "t3.micro" min_size = 1 max_size = 2 db_instance_class = "db.t3.micro" enable_deletion_protection = false } staging = { instance_type = "t3.small" min_size = 1 max_size = 3 db_instance_class = "db.t3.small" enable_deletion_protection = false } prod = { instance_type = "m5.large" min_size = 2 max_size = 10 db_instance_class = "db.m5.large" enable_deletion_protection = true } } } # main.tf: localsのマップをfor_eachで展開する module "app_env" { for_each = local.env_config source = "./modules/app-env" env_name = each.key instance_type = each.value.instance_type min_size = each.value.min_size max_size = each.value.max_size db_instance_class = each.value.db_instance_class enable_deletion_protection = each.value.enable_deletion_protection }

このパターンの大きなメリットは「新しい環境を追加するとき、localsのマップに1エントリ追加するだけで完結する」点です。本番環境だけ enable_deletion_protection = true にするといった環境固有の設定もマップ内で明示できます。

運用が本格化してパラメータが増えてきたら、locals.tfを独立ファイルにして環境設定を集中管理することをお勧めします。module本体のコードには環境差分を持ち込まず、ロジックと設定を分離するのが実務での設計の鉄則です。

管理環境が10を超えるような大規模構成になってきたら、Terraformのラッパーツール「Terragrunt」を検討する価値があります。TerragruntはS3バックエンドの設定(バケット名・DynamoDBテーブル名)を環境名から自動生成する仕組みや、複数モジュールを依存関係の順に一括apply/destroyするrun-all機能を持ちます。locals+for_eachで書けるうちは素のTerraformで進め、backend設定の三重管理が限界に感じてきたタイミングで導入を判断するとよいです。

12. for_eachで管理頻度の高いリソースを個別管理する

Security Groupのインバウンドルールのように追加・削除の頻度が高いリソースは、for_eachを使ってルール単位でstateを分ける設計が有効です。インラインの ingress ブロックをリソース定義の中に書くと、後から特定のルールだけ削除しようとしたときにSecurityGroup全体が再作成されることがあります。aws_security_group_rule リソースをfor_eachで管理すると、ルール単位でstateが分かれるため削除時の影響範囲を最小化できます。

variable "ingress_rules" { type = map(object({ from_port = number to_port = number protocol = string cidr_blocks = list(string) })) default = { "ssh" = { from_port = 22, to_port = 22, protocol = "tcp", cidr_blocks = ["10.0.0.0/8"] } "http" = { from_port = 80, to_port = 80, protocol = "tcp", cidr_blocks = ["0.0.0.0/0"] } "https" = { from_port = 443, to_port = 443, protocol = "tcp", cidr_blocks = ["0.0.0.0/0"] } } } resource "aws_security_group_rule" "ingress" { for_each = var.ingress_rules security_group_id = aws_security_group.app.id type = "ingress" from_port = each.value.from_port to_port = each.value.to_port protocol = each.value.protocol cidr_blocks = each.value.cidr_blocks description = each.key }

sshルールだけ削除したいときは var.ingress_rules からsshのキーを外すだけで、httpとhttpsのルールには差分が出ません。メンバーの増減が定期的に起きるIAMユーザー管理も同様で、for_eachで管理することで変数ファイルへのメンバーリスト追記だけで操作が完結します。

# チームメンバーリストからIAMユーザーを一括作成・管理する例 variable "dev_team_members" { type = list(string) default = ["alice", "bob", "carol", "dave"] } resource "aws_iam_user" "dev" { for_each = toset(var.dev_team_members) name = each.value tags = { Team = "dev" } } resource "aws_iam_user_group_membership" "dev" { for_each = toset(var.dev_team_members) user = aws_iam_user.dev[each.value].name groups = ["developers"] }

メンバーを追加するときは var.dev_team_members にユーザー名を足すだけです。既存メンバーへの影響はゼロで、追加されたユーザーのリソースだけが差分として出ます。コードレビューを通じてメンバーの追加・削除を制御できる点もチーム運用での実務的なメリットです。

dynamic blockでfor_eachを活用する

for_eachはリソース自体の繰り返しだけでなく、リソース内のブロック要素の繰り返しにも使えます。これをdynamic blockといい、セキュリティグループのingressルールのように「数が変動する設定ブロック」を宣言的に記述できます。

13. dynamic blockの基本(セキュリティグループのingressルール)

# dynamic blockでingressルールを動的生成する例 variable "ingress_rules" { type = list(object({ port = number protocol = string cidr_blocks = list(string) description = string })) default = [ { port = 22, protocol = "tcp", cidr_blocks = ["10.0.0.0/8"], description = "SSH from internal" }, { port = 80, protocol = "tcp", cidr_blocks = ["0.0.0.0/0"], description = "HTTP" }, { port = 443, protocol = "tcp", cidr_blocks = ["0.0.0.0/0"], description = "HTTPS" }, ] } resource "aws_security_group" "web" { name = "web-sg" vpc_id = var.vpc_id dynamic "ingress" { for_each = var.ingress_rules content { from_port = ingress.value.port to_port = ingress.value.port protocol = ingress.value.protocol cidr_blocks = ingress.value.cidr_blocks description = ingress.value.description } } egress { from_port = 0 to_port = 0 protocol = "-1" cidr_blocks = ["0.0.0.0/0"] } }

dynamic blockを使わない場合、ingressブロックをルールの個数分コピーして書かなければなりません。dynamic blockにすることで変数でルールを管理でき、ルールの追加・削除が変数の編集だけで完結します。

ひとつ重要な違いがあります。dynamic blockのfor_eachはlistを渡しても動作します。これはリソース単位のfor_each(setやmapが必要)と異なる動作です。dynamic blockで作成されるブロックはtfstateの独立したリソースではなく「1つのリソースの設定の一部」として扱われるため、リストのインデックスずれが本番リソースの破棄につながることはありません。

よくあるトラブルと解決法

14. 「Error: Duplicate resource」が出る

for_each のキーに重複がある場合に発生します。同じキーを2つのマップに使っていないか確認してください。

# エラーになる例(重複キー) variable "servers" { default = { "web" = { ... } "web" = { ... } # NG: 同じキー "web" が2つある } } # 実際の確認コマンド terraform plan 2>&1 | grep -i "duplicate"

15. 「Error: Invalid for_each argument」が出る

このエラーには2つの異なる原因があります。

原因1: list型をそのまま渡している

for_eachはsetまたはmapしか受け付けません。変数の型定義を確認して対処します。

# エラーになるパターン(list型をそのまま渡している) for_each = var.instance_names # type = list(string) だとエラー # 解決策1: 変数の型をset(string)に変更する(推奨) variable "instance_names" { type = set(string) } # 解決策2: toset()関数でlist型をset型に変換する for_each = toset(var.instance_names)

原因2: apply前に値が確定しないリソース属性をキーに使っている

for_eachのキーはplan実行時点で値が確定していなければなりません。まだ作られていないリソースのidなど、apply前には確定しない値をキーに使うと以下のエラーが出ます。

# エラーになるパターン(apply前未確定の値をキーに使う) resource "aws_subnet" "main" { for_each = aws_vpc.main.id # plan時点ではidが確定しないためエラー ... } # エラーメッセージ(抜粋) # Error: Invalid for_each argument # The "for_each" value depends on resource attributes that cannot be # determined until apply, so Terraform cannot predict how many instances # will be created. To work around this, use the -target argument to first # apply only the resources that the for_each depends on.

この場合の解決策は2つあります。ひとつは、localsで「plan時点で確定できる固定文字列」をキーとして使う方法です。

# 解決策1: plan時点で確定できる固定文字列をキーにする locals { subnet_types = toset(["public", "private"]) } resource "aws_subnet" "main" { for_each = local.subnet_types vpc_id = aws_vpc.main.id cidr_block = each.key == "public" ? "10.0.1.0/24" : "10.0.2.0/24" availability_zone = "ap-northeast-1a" tags = { Name = each.key } }

もうひとつは、エラーメッセージにも記載されている -target を使って依存元リソースだけを先にapplyし、2回に分けて実行する方法です。

# 解決策2: -targetで依存元リソースを先にapplyする(2段階実行) # ステップ1: for_eachが依存するVPCだけ先にapply terraform apply -target=aws_vpc.main # ステップ2: VPCのidが確定した後で全体をapply terraform apply

-target を使うアプローチは応急処置的であり、可能であれば固定文字列キーを使う設計に変更することが望ましいです。

16. 「toset requires string values」エラーが出る

toset() 関数に数値型や null を含む値を渡したときに発生します。

# エラーになるパターン(数値リストをそのまま toset に渡している) variable "port_numbers" { type = list(number) default = [80, 443, 8080] } resource "aws_security_group_rule" "ingress" { for_each = toset(var.port_numbers) # NG: number 型は toset() に渡せない from_port = tonumber(each.key) to_port = tonumber(each.key) protocol = "tcp" }

解決策は tostring() で文字列に変換してから渡すか、変数の型を最初から set(string) で定義することです。

# OK1: for式で tostring() を使って文字列に変換してから toset に渡す resource "aws_security_group_rule" "ingress" { for_each = toset([for n in var.port_numbers : tostring(n)]) from_port = tonumber(each.key) to_port = tonumber(each.key) protocol = "tcp" } # OK2: 変数を最初から set(string) 型で定義する(推奨) variable "port_numbers" { type = set(string) default = ["80", "443", "8080"] }

17. moduleを削除するとリソースが消える

moduleブロックをコメントアウトしたり削除したりすると、そのmodule内のリソースが全て削除されます。これは意図通りの動作ですが、誤って消してしまう事故が多いです。

削除前に必ず terraform plan でdestroy対象を確認してください。本番環境での削除は lifecycle { prevent_destroy = true } を設定しておくと安全です。

# 削除を防ぐlifecycleの設定 resource "aws_db_instance" "main" { ... lifecycle { prevent_destroy = true } } # terraform planで削除対象を必ず確認する terraform plan -out=tfplan terraform show -json tfplan | jq '.resource_changes[] | select(.change.actions[] == "delete")'

18. for_each でセットを使う場合の注意点

set型のfor_eachを使う場合、要素の順序が保証されません。また、セットの要素はキーとしてそのまま使われるため、要素の値が変わると「削除して再作成」になります。

# setを使う例(シンプルなケース) variable "availability_zones" { type = set(string) default = ["ap-northeast-1a", "ap-northeast-1c", "ap-northeast-1d"] } resource "aws_subnet" "public" { for_each = var.availability_zones vpc_id = aws_vpc.main.id availability_zone = each.key cidr_block = cidrsubnet(aws_vpc.main.cidr_block, 8, index(tolist(var.availability_zones), each.key)) }

19. countからfor_eachへの移行でリソースが破棄される問題

既存のcountリソースをfor_eachに切り替えると、stateのキーがインデックスから文字列に変わるため、Terraformが全リソースを破棄・再作成しようとします。本番環境で突然この切り替えを行うと、サービス停止が発生する危険があります。

方法1: movedブロックで安全に移行する(推奨・Terraform 1.1以降)

Terraform 1.1で導入された moved ブロックを使うと、tfstateのキーをコード上で宣言的に書き換えられます。リソースを一切破棄せずに移行できるため、本番環境での移行に適しています。

# 移行前の対応関係 # aws_instance.web[0] -> "web-01" # aws_instance.web[1] -> "web-02" # aws_instance.web[2] -> "web-03" # moved.tf に移行マッピングを宣言 moved { from = aws_instance.web[0] to = aws_instance.web["web-01"] } moved { from = aws_instance.web[1] to = aws_instance.web["web-02"] } moved { from = aws_instance.web[2] to = aws_instance.web["web-03"] }

main.tfでfor_eachに書き換えつつ、moved.tfに上記の宣言を書いてから terraform plan を実行します。成功すれば以下のような出力になります。

# terraform plan の出力(抜粋) # aws_instance.web["web-01"] has moved to aws_instance.web["web-01"] resource "aws_instance" "web" { id = "i-0abc1234def56789a" # (no changes) } Plan: 0 to add, 0 to change, 0 to destroy.

「0 to add, 0 to change, 0 to destroy」であれば、既存リソースへの影響なしに移行できています。applyを実行するとtfstateのキーだけが書き換わります。apply完了後は moved.tf の該当ブロックを必ず削除してください。movedブロックはstate変換の一時的な記述であり、適用後も残しておく必要はありません。不要なブロックを消し忘れると、後続のplan実行時に混乱の原因になります。

方法2: terraform state mvコマンドで移行する

Terraform 1.0以前の環境、またはmovedブロックを使えない場面では terraform state mv でstateのキーを先に書き換えてから、コードを変更する手順を踏みます。

# countからfor_eachへの移行手順(3台の例) # 移行前: aws_instance.web[0] -> 移行後: aws_instance.web["web-01"] terraform state mv 'aws_instance.web[0]' 'aws_instance.web["web-01"]' terraform state mv 'aws_instance.web[1]' 'aws_instance.web["web-02"]' terraform state mv 'aws_instance.web[2]' 'aws_instance.web["web-03"]' # state移行後にコードをfor_eachに書き換えてplan実行 # Plan: 0 to add, 0 to change, 0 to destroy. になれば成功

state mvの実行後は必ずterraform planで差分がないことを確認してからapplyに進んでください。確認なしでapplyすると、想定外の差分が残っていた場合にリソースの再作成が発生します。

# state mv後の確認(「No changes」になれば移行成功) $ terraform plan No changes. Your infrastructure matches the configuration. # 差分が出た場合は中止して原因を調査する

20. moduleのsourceを変更すると既存リソースが削除される

moduleのsourceパスを変更(例:ローカルパス→Terraform Registryへの移行)した場合、Terraformはそれを「別のmodule」として認識し、既存リソースを削除して再作成しようとします。

これを防ぐには terraform state mv コマンドで既存リソースを新しいmoduleのアドレスに移動してから plan/apply します。

# stateを移動してリソースを保護する例 # 旧アドレス -> 新アドレスに移動 terraform state mv 'module.old_name.aws_instance.web' 'module.new_name.aws_instance.web' # 確認 terraform state list | grep module

21. count = 0のリソースを直接参照するとエラーになる

countで条件付きリソース(count = var.flag ? 1 : 0)を作成するとき、count = 0の状態で当該リソースの属性を直接参照するとエラーになります。

resource "aws_eip" "nat" { count = var.create_nat ? 1 : 0 domain = "vpc" } # NG: count = 0のとき aws_eip.nat はリスト(長さゼロ)になるため直接参照はエラー output "nat_ip" { value = aws_eip.nat.public_ip # エラー }

countで作成されたリソースはリスト形式で管理されます。count = 0のときはリストの長さがゼロになり、インデックスなしの直接参照でエラーになります。length()で存在確認してから参照するか、try()関数を使って安全に処理するのが正しいパターンです。

# OK1: length()で存在確認してから参照する output "nat_ip" { value = length(aws_eip.nat) > 0 ? aws_eip.nat[0].public_ip : null } # OK2: try()関数で安全に処理する(count=0の場合はnullを返す) output "nat_ip_v2" { value = try(aws_eip.nat[0].public_ip, null) }

splat式の結果が空リストになるケースも同様です。環境フラグで count = 0 になる条件があると、splat式の結果は空リスト [] になります。受け取り側のモジュールが要素数1以上を前提にしていると予期せぬエラーを招くため、length() で分岐するか try() 関数で安全に処理してください。

22. .terraform/ ディレクトリとtfstateをgitignoreに含めていない

チームでTerraformを使い始めたときに多いミスです。terraform init が生成する .terraform/ ディレクトリにはプロバイダのバイナリが含まれており、コミットしてしまうとリポジトリが数十MB単位で肥大化します。また、ローカルバックエンドを使っている場合の terraform.tfstate をコミットすると、複数人が同時に操作したときにstateの競合が起きます。

# Terraformプロジェクトの標準 .gitignore .terraform/ .terraform.lock.hcl # lockファイルはチームで共有する場合は含める terraform.tfstate terraform.tfstate.backup *.tfvars # 機密値を含む変数ファイルは必ず除外

.terraform.lock.hcl はプロバイダのバージョンロックファイルです。チームで同じプロバイダバージョンを使うために、このファイルはgitignoreに含めずコミット対象にすることを推奨します。一方、機密値(APIキーやパスワード)を含む .tfvars ファイルは必ずgitignoreに追加してください。

23. 「The given key does not identify an element in this collection value」が出る

for_eachに渡したマップに存在しないキーを参照しようとしたときに発生します。localsや変数で定義したマップのキー名と、outputや別リソースでのキー参照が一致しているか確認してください。

# エラーになる例(参照側のキー名がマップに存在しない) locals { server_map = { web = { instance_type = "t3.micro" } app = { instance_type = "t3.small" } } } # "db" というキーは上のマップに存在しないためエラー output "db_type" { value = local.server_map["db"].instance_type } # 修正方法1: try()でデフォルト値を返す output "db_type_safe" { value = try(local.server_map["db"].instance_type, "t3.micro") } # 修正方法2: lookup()でデフォルト値を指定する output "db_type_lookup" { value = lookup(local.server_map, "db", { instance_type = "t3.micro" }).instance_type }

このエラーはfor_eachで展開したモジュールの出力を参照するときにも起きます。module.env["staging"].app_url のように書いたとき、local.environments に staging キーが存在するか再確認するとよいです。

24. 「A moved object can only be used to move to an address that refers to...」が出る

movedブロックの from または to に、stateに存在しないリソースアドレスを指定したときに発生します。

まず terraform state list で現在のstateキーを確認してから、movedブロックを書くようにしてください。

# 現在の state キーを確認してから moved ブロックを書く terraform state list | grep aws_instance # 出力例(環境により異なります) aws_instance.web[0] aws_instance.web[1] aws_instance.web[2] # 確認した上で正しいアドレスを moved ブロックに記述する moved { from = aws_instance.web[0] # state list に存在するアドレスを from に書く to = aws_instance.web["web-01"] }

countリソースのアドレスは aws_instance.web[0] であり、aws_instance.web.0 や aws_instance.web["0"] ではありません。括弧・引用符のスタイルに注意してください。

本記事のまとめ

terraform moduleとfor_each・count、そしてfor式・splat式の設計パターンをまとめます。
やりたいこと 使い方
リソース定義を部品として再利用する module "name" { source = "..." }
指定した数だけリソースを作る count = 3 で count.index を参照
マップ/セットで繰り返す for_each = var.map で each.key/each.value
リスト型をfor_eachに渡す for_each = toset(var.list)
moduleにfor_eachを使う module "env" { for_each = local.envs }
環境設定を一元管理する localsブロックにマップで定義しfor_eachで展開する
途中の要素を削除しても安全に countではなくfor_eachを選ぶ
for_eachのマップを条件でフィルタリングする localsでfor式(for k, v in var.map : k => v if v.enable)
リストからリストを変換する [for x in list : 変換式]
リストからマップを生成する { for x in list : x.key => x.val }
重複キーの値をリストにまとめる { for x in list : x.key => x.val... }(グループ集約形式)
countリソースの属性一覧を取得する resource[*].id(splat式)
for_eachリソースの属性一覧を取得する [for r in resource : r.id] または values(resource)[*].id
for_eachリソースを別のリソースのfor_eachに渡す for_each = aws_instance.web(リソース全体を渡す)
リソース内のブロックを動的生成する dynamic "ブロック名" { for_each = ... }
moduleの出力を別moduleに渡す module.module_name.output_name で参照
誤削除を防ぐ lifecycle { prevent_destroy = true }
countからfor_eachへ安全に移行する movedブロックでstateキーを宣言的に書き換える(Terraform 1.1以降)。apply後にmovedブロックを削除する
stateのリソースを移動する terraform state mv 旧アドレス 新アドレス
リソースを条件付きで作る・作らない count = 条件 ? 1 : 0
count = 0のリソースの属性を参照する length(resource) > 0 ? resource[0].attr : null または try(resource[0].attr, null)
for_eachのキーをplan時点で確定させる localsの固定文字列セット/マップをキーにする
for_eachの依存元リソースを先にapplyする terraform apply -target=依存リソース の2段階実行
planでdestroyや再作成を素早く確認する terraform plan | grep -E "destroy|forces replacement"
存在しないキーへの参照を安全に処理する try(map["key"].attr, default) または lookup(map, "key", default)
数値リストをfor_eachに渡す toset([for n in var.nums : tostring(n)]) で文字列化してから渡す
Security Groupルールを個別管理する aws_security_group_rule をfor_eachで管理し、ルール単位でstateを分ける
チームメンバーリストからIAMユーザーを管理する toset(var.members) をfor_eachに渡す。メンバー変更はリスト変数の編集だけで完結
moduleとfor_each/countを組み合わせることで、コードの重複を排除し、環境差分を変数だけで表現できるようになります。localsブロックへの環境設定の集約とfor_eachの組み合わせは、チームで運用するリポジトリで特に効果を発揮します。「prod環境のスペックを変えたいとき、どのファイルを編集すればいいか」が誰でも一目でわかるからです。

countは直感的でシンプルですが、リストへの変更が発生する構成に使い続けると本番環境で意図しないリソース破棄を引き起こします。迷ったらfor_eachを選んでおく方が、長期的な運用リスクを下げられます。for_eachのキーは後から変えられない設計判断だということを念頭に置き、役割を表す論理名を最初から選ぶようにしてください。

既存のcountコードをfor_eachに切り替えたい場合は、Terraform 1.1以降であれば moved ブロックを使うとリソースを一切破棄せずに移行できます。planで「0 to add, 0 to change, 0 to destroy」を確認してからapplyし、apply完了後はmovedブロックを削除するのが安全な手順です。

for式とsplat式は、モジュール間でリソース属性のリストを渡す場面で必ず必要になります。countリソースはsplat式(resource[*].id)で、for_eachリソースはfor式またはvalues()との組み合わせで対応します。この使い分けを押さえておくと、モジュールのoutput設計が格段にすっきりします。

最初は「module化するほど規模がない」と感じるかもしれませんが、3つ目の環境を作る前に設計しておくことをお勧めします。後からの切り出しは想像以上に手間がかかります。

Terraformでのインフラ設計をさらに深めたい方は、tfstateのチーム運用や変数の設計パターンも合わせて学ぶと、より堅牢な構成管理ができるようになります。

・postfix mynetworks の書き方はこちら
現場で通用する安全なLinuxサーバー構築の「型」を体系的に身につけたい方へ、TerraformのIaC設計からモジュール構成・for_each活用まで体系的に学べるセミナーを開催しています。
Terraform実践セミナーの詳細を見る >>

無料メルマガで学習を続ける

Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。

登録無料・いつでも解除できます

暗記不要・1時間後にはサーバーが動く

3,100名以上が実践した「型」を無料で公開中

プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。

姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

Linux無料マニュアル(図解60P) 名前とメールで30秒登録

運営

リナックスマスター.JP(代表 宮崎智広)

株式会社イーネットマーキュリーが運営するLinux教育サイトです。代表の宮崎智広は現役のLinuxサーバー管理者として20年以上の実務経験を持ち、累計3,100名以上のエンジニアを指導してきました。実践型のLinuxセミナーや無料マニュアルの配布を通じてLinux人材の育成に取り組んでいます。