この記事は以前Qiitaにて公開したものになります。
元記事はこちら : Local Valueとfor_eachを使ってリソース定義を楽したい
tl;dr
Local Value で定義したいリソースのパラメータを事前に用意し、 for_each でそれを読み込むとresource定義はひとつで済むので便利。
まえがき
terraformでリソースを定義するとき、名前や保持期間など、一部パラメータが違うだけのほとんど同じリソースを複数定義することがあります。
AWSで言うと、たとえばElastic Container RegistryやCloudwatch Logsのロググループなどが該当します。
これらのリソースを一個一個定義するのもいいのですが、時には短く書きたい場合もあります。
そんなときに便利な、Local Value と for_each について紹介します。
やってみる
キーだけを参照するシンプルな例
まずは実際のコードを例示します。
以下のコードは、Elastic Container Registryのリポジトリを for_each で定義するものです。
まずは、Local Valueとしてリソースごとに変更させたいもののリストを定義します。
今回はリポジトリ名のみを可変にしたいので、aws_ecr_repository.repositories という名前の list(string) 型の変数として定義します。
locals {その後、リソースを定義する時に、リソースの中で for_each を使います。
aws_ecr_repository = {
repositories = [
"php",
"nginx",
]
}
}
# リストを元にリソースを作成するこれをapplyすると、
resource "aws_ecr_repository" "repositories" {
for_each = toset(local.aws_ecr_repository.repositories) # aws_ecr_repository.repositories の数だけリソースを定義する
name = each.key # repositoriesのキー(php, nginx)が参照される
image_tag_mutability = "MUTABLE"
}aws_ecr_repository.repositories[] が定義されます。
他のリソースから特定のリポジトリを参照したい場合は、aws_ecr_repository.repositories[リストのキー] で参照できます。
上記のサンプルコードだと、aws_ecr_repository.repositories["php"], aws_ecr_repository.repositories["nginx"] のようにします。
キー・バリューを活用する例
先ほどの例では、シンプルに名前のリストを作ってそのぶんだけリソースを作る、というものでした。
実際には、リソースごとに微妙に変えたい値があるケースもあります。
そうした場合、下記のようにkey-valueの形式を使って、リソースによって変えたい値を含めたLocal Valueを定義すると便利です。
CloudflareのDNSレコードを定義するコードで例示します。
まずは、このようにLocal Valueを定義します。
locals {そして、以下のようにkeyに加えてvalueも参照します。
records = {
"example.com" = { value = "example.com", comment = "hoge", proxied = false }
"www" = { value = "example.com", comment = "piyo", proxied = true }
}
}
# CNAME RecordsDNSのTTLや向き先、ログの保持期間など、リソースごとのちょっとした差分についてもLocal Valueを使うことで吸収し
resource "cloudflare_record" "cname" {
for_each = local.records
zone_id = var.cloudflare_zone_id
name = each.key # "example.com", "www" が参照される
comment = each.value.comment
type = "CNAME"
value = each.value.value
proxied = each.value.proxied
allow_overwrite = false
}for_each で楽してリソース定義できます。
まとめ
こうした for_each を使った書き方を使うことで、同じようなリソースの定義が楽になります。
また、嬉しい副作用として、localsを見ればそのtfファイルで何を定義しているかがすぐにわかるようにもなります。
使ったことがなければ、一度試してみることをおすすめします。
(もちろん、複雑な差分がある場合には個別にresourceブロックを記述することをおすすめします。あくまでシンプルな差分で使うのがよさそうです！)