Terraformのfor式でlist・mapを動的に変換する設計パターン|localsを活用したDRY化と実務のつまずき解消

運営:リナックスマスター.JP(代表 宮崎智広)
HOME > Linux技術 リナックスマスター.JP(Linuxマスター.JP) > Terraform > Terraformのfor式でlist・mapを動的に変換する設計パターン|localsを活用したDRY化と実務のつまずき解消
「terraform for_eachとfor式、同じforとついているのに何が違うのか」
Terraformを使い始めると、こういう疑問にぶつかることがあります。

コードが増えてくると、同じような設定が何か所にも散らばってくる。
そうなって初めて「もっとシンプルに書けないか」と感じる場面が出てきます。

この記事では、HCLのfor式(for expression)の仕組みと、localsと組み合わせたデータ変換設計のパターンを解説します。RHEL 9系/Ubuntu 24.04 LTSを想定環境として、Terraform 1.5以降の構文を使います。
コマンドオプションの暗記ではなく、コードの整理と設計判断を中心に説明します。

この記事のポイント

・for式はlist・mapを変換するHCL構文で、for_eachとは別物
・localsでfor式を使ってデータを前処理すると、resourceブロックがすっきりする
・ネストしたfor式はlocalsで段階的に分割すると保守性が上がる
・よくあるエラーの原因はfor式とfor_eachの混同がほとんど


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

for_eachとfor式は別物である

Terraformで「for」という言葉が出てくると、2つの意味があります。

1つ目はfor_eachメタ引数。リソースを複数作るときに使います。
2つ目は「for式」(for expression)。変数の値を加工・変換するHCL構文です。

この2つは目的が根本的に違います。

1. for_each:リソースを複数作るための指示

for_eachはリソースブロックの中に書く「メタ引数」です。
コレクション(list・map)に対してリソースを1件ずつ作るよう指示します。

# for_each でリソースを複数作る resource "aws_s3_bucket" "logs" { for_each = toset(["access", "error", "audit"]) bucket = "my-app-${each.key}-logs" }

この場合、「access」「error」「audit」の3つに対してS3バケットが1つずつ作られます。

2. for式:データを変換するHCL構文

for式はリソースを作るのではなく、listやmapの値を変換するための式です。
localsや変数のデフォルト値、リソース引数の値を計算するときに使います。

# for式:リストの文字列をすべて大文字に変換する locals { upper_names = [for s in var.names : upper(s)] }

リソースが増えるわけではありません。
データの形を変えているだけです。

list変換の基本構文

for式の基本形は次のとおりです。

[for <要素> in <コレクション> : <変換式>]

1. 文字列リストを変換する

variable "env_names" { type = list(string) default = ["dev", "stg", "prod"] } locals { # 各要素を大文字に変換してリストを作る env_upper = [for e in var.env_names : upper(e)] # 出力例(環境により異なります): ["DEV", "STG", "PROD"] # S3バケット名のプレフィックスを付ける bucket_names = [for e in var.env_names : "myapp-${e}-logs"] # 出力例(環境により異なります): ["myapp-dev-logs", "myapp-stg-logs", "myapp-prod-logs"] }

2. オブジェクトのリストから属性を取り出す

タグ情報をオブジェクトのリストで管理するケースがあります。

variable "instances" { type = list(object({ name = string env = string })) default = [ { name = "web-1", env = "prod" }, { name = "web-2", env = "prod" }, { name = "app-1", env = "stg" }, ] } locals { # name属性だけのリストを作る instance_names = [for inst in var.instances : inst.name] # 出力例(環境により異なります): ["web-1", "web-2", "app-1"] }

map変換とkey抽出の基本構文

リストではなくmapを作りたいときは、波括弧で囲んでキーと値を指定します。

{for <キー>, <値> in <コレクション> : <新キー> => <新値>}

1. mapのキーを変換してmapを作り直す

variable "port_map" { type = map(string) default = { http = "80" https = "443" ssh = "22" } } locals { # 値をnumber型に変換したmapを作る port_numbers = {for k, v in var.port_map : k => tonumber(v)} # 出力例(環境により異なります): { http = 80, https = 443, ssh = 22 } }

2. listからmapを作る

リストをmapに変換するパターンも実務でよく使います。
インデックスをキーにすることで、後段の処理で番号参照できるようになります。

locals { subnets = ["subnet-aaa", "subnet-bbb", "subnet-ccc"] # インデックスをキーにしてmapを作る subnet_map = {for idx, s in local.subnets : idx => s} # 出力例(環境により異なります): { 0 = "subnet-aaa", 1 = "subnet-bbb", 2 = "subnet-ccc" } }

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

for式の末尾にifを付けると、条件を満たす要素だけを取り出せます。

[for <要素> in <コレクション> : <変換式> if <条件>]

1. 本番環境のリソースだけを取り出す

locals { # envが"prod"の要素だけを取り出す prod_instances = [for inst in var.instances : inst if inst.env == "prod"] # name属性だけを取り出したリストにする prod_names = [for inst in var.instances : inst.name if inst.env == "prod"] # 出力例(環境により異なります): ["web-1", "web-2"] }

2. 空文字を除外してリストをきれいにする

変数から受け取ったリストに空文字列が混じることがあります。
フィルタリングで取り除くと、後段の処理が安全になります。

variable "tags" { type = list(string) default = ["prod", "", "web", ""] } locals { # 空文字列を除外する non_empty_tags = [for t in var.tags : t if t != ""] # 出力例(環境により異なります): ["prod", "web"] }

localsと組み合わせたデータ変換パイプライン設計

for式の真価は、localsに中間データを定義して段階的にデータを加工できることです。
一度に複雑な変換をしようとすると読みにくくなるため、段階を分けることを意識します。

Terraformのfor式も含めたHCLの設計パターンについては、Terraform学習ロードマップで体系的に整理しています。

1. 段階的に変換するパイプライン設計

次の例は「インスタンスリストからタグ情報を整形してリソースに渡す」という流れです。

variable "instances" { type = list(object({ name = string env = string owner = string })) } locals { # ステップ1:本番環境のインスタンスだけ取り出す prod_instances = [for inst in var.instances : inst if inst.env == "prod"] # ステップ2:for_eachで使えるmapに整形する(キーはname) prod_instance_map = {for inst in local.prod_instances : inst.name => inst} } resource "aws_instance" "prod" { for_each = local.prod_instance_map # (ami・instance_typeなどの設定は省略) tags = { Name = each.value.name Env = each.value.env Owner = each.value.owner } }

localsで段階的に変換しておくことで、resourceブロックがシンプルになります。
一気にresourceブロックの中でfor式を使おうとすると、読みにくくなるため注意です。

2. for式のネストに注意する

for式のネストは技術的には可能ですが、読みにくくなります。
localsでの段階分割を先に検討します。

# 推奨しない:ネストしたfor式(読みにくい) locals { bad_example = { for env, instances in var.env_instances : env => [for inst in instances : upper(inst.name)] } } # 推奨:localsで段階を分ける locals { # ステップ1:各インスタンスのnameを大文字にしたmapを作る upper_names_by_env = { for env, instances in var.env_instances : env => [for inst in instances : upper(inst.name)] } }

この例のように1段のネストであっても、3行以上になるfor式はlocalsでの分割を検討します。

for式とdynamic blockの使い分け

for式と混同しやすいのがdynamicブロックです。
目的が明確に違うため、整理しておきます。
構文 目的 使う場所
for式 list・mapを変換・フィルタリングして値を返す localsの値、変数のデフォルト値、リソース引数の値
dynamic block リソース内のブロック構造を繰り返し生成する リソースブロック内(ingressブロックなど)
for式は「値を返す」構文で、dynamicは「ブロックを生成する」構文です。

使い分けの判断例

セキュリティグループのingressルールを複数作りたい場合:

variable "allowed_ports" { type = list(number) default = [80, 443, 8080] } resource "aws_security_group" "web" { name = "web-sg" # dynamic blockでingressブロックを繰り返す dynamic "ingress" { for_each = var.allowed_ports content { from_port = ingress.value to_port = ingress.value protocol = "tcp" cidr_blocks = ["0.0.0.0/0"] } } } locals { # for式でポートのlistをmapに変換する(データ変換の例) port_descriptions = {for p in var.allowed_ports : tostring(p) => "allow-${p}"} # 出力例(環境により異なります): { "80" = "allow-80", "443" = "allow-443", "8080" = "allow-8080" } }

ingressブロックを繰り返すのはdynamicの役割です。
for式でポートのラベルmapを作るのは値の変換です。
それぞれ目的に応じて使い分けます。

トラブルシュート:for式でよく出るエラーと解消パターン

1.「This object does not have an attribute named」エラー

オブジェクトのリストに対してfor式を使うとき、属性名のタイポが原因です。

# エラーの例(属性名のタイポ) locals { names = [for inst in var.instances : inst.Names] # Namesは存在しない } # 修正後 locals { names = [for inst in var.instances : inst.name] # 正しくは name(小文字) }

terraform consoleでオブジェクトの構造を確認してから書くと、このミスを防げます。

# terraform console で変数の内容を確認する $ terraform console > var.instances # 出力例(環境により異なります) [ { "env" = "prod" "name" = "web-1" }, ]

2. for式の結果をresourceブロックに直接使おうとするとエラー

for式が返すのはリストやmapの値であり、リソースのブロック構造ではありません。
リソースを複数作りたい場合はfor_eachを使います。

# エラー:for式をresourceに直接書くことはできない resource "aws_s3_bucket" "example" { [for name in var.names : {bucket = name}] # これはHCL構文エラー } # 正解:localsでsetに変換してfor_eachで使う locals { bucket_set = toset(var.names) } resource "aws_s3_bucket" "example" { for_each = local.bucket_set bucket = each.key }

3. mapのfor式でキーが重複するとエラー

for式でmapを作るとき、同じキーが複数出てくるとエラーになります。

# エラーの例(envが重複するとmapのキーが重複する) locals { env_map = {for inst in var.instances : inst.env => inst.name} # envに"prod"が複数あるとエラーになる } # 修正:ユニークなキーを使う locals { # nameをキーにすれば重複しない(nameがユニークな場合) name_map = {for inst in var.instances : inst.name => inst} }

4. for_eachにlistを渡すとエラーになる

for_eachにlistを渡すとエラーになります。toset()でセットに変換します。

# エラー:for_eachにlistを直接渡すとエラー resource "aws_s3_bucket" "example" { for_each = var.names # listはfor_eachに使えない } # 正解:tosetでセットに変換する resource "aws_s3_bucket" "example" { for_each = toset(var.names) bucket = each.key }

for式で事前にtoset()を使ってlocalsを作るパターンも有効です。

locals { bucket_set = toset([for name in var.names : lower(name)]) } resource "aws_s3_bucket" "example" { for_each = local.bucket_set bucket = each.key }

本記事のまとめ

やりたいこと 使う構文
listの各要素を変換する [for item in list : transform(item)]
mapのキーと値を変換する {for k, v in map : k => transform(v)}
条件に合う要素だけ取り出す [for item in list : item if condition]
listからmapを作る {for idx, s in list : idx => s}
for式を使ってfor_eachに渡す toset([for s in list : transform(s)])
複雑な変換を整理する localsで段階的に分割する
リソース内ブロックを繰り返す dynamic block(for式ではない)
for式を使うとコードがすっきりしますが、ネストが深くなりすぎると逆に読みにくくなります。
localsで段階的に変換する設計が、実務での保守性を高めるポイントです。
現場で通用する安全なLinuxサーバー構築の「型」を体系的に身につけたい方へ、
>>【初心者向けLinuxセミナー(2日間ハンズオン)】

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

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

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

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

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

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

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

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

運営

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

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