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の混同がほとんど
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
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" }
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)] } }
localsでの分割を検討します。for式とdynamic blockの使い分け
for式と混同しやすいのがdynamicブロックです。目的が明確に違うため、整理しておきます。
| 構文 | 目的 | 使う場所 |
|---|---|---|
| for式 | list・mapを変換・フィルタリングして値を返す | localsの値、変数のデフォルト値、リソース引数の値 |
| dynamic block | リソース内のブロック構造を繰り返し生成する | リソースブロック内(ingressブロックなど) |
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" } }
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 }
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式ではない) |
localsで段階的に変換する設計が、実務での保守性を高めるポイントです。
>>【初心者向けLinuxセミナー(2日間ハンズオン)】
3,100名以上が実践した「型」を無料で公開中
プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら
- 前のページへ:LocalStackとTerraformでAWSをローカルテストする方法|アカウント不要の開発・デバッグ環境設計
- この記事の属するカテゴリ:Terraformへ戻る

無料メルマガで学習を続ける
Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。
登録無料・いつでも解除できます