terraform consoleコマンドでHCL式を対話検証する方法｜変数・関数・条件式のデバッグ実践手順

この記事のポイント

・terraform console でHCL式をplan不要で対話確認できる
・var.変数名・local値・data sourceも console で参照可能
・cidrsubnet・jsonencode・formatlist等の関数をその場で試せる
・for式・条件式のデバッグに console は特に効果的

# terraform console を起動する
$ cd /path/to/terraform-project
$ terraform console
>

> exit
$

# variables.tf
variable "region" {
  default = "ap-northeast-1"
}

variable "instance_type" {
  default = "t3.micro"
}

> var.region
"ap-northeast-1"
> var.instance_type
"t3.micro"

# tfvars を明示して起動する場合
$ terraform console -var-file=dev.tfvars
> var.env
"dev"

# main.tf
locals {
  name_prefix = "${var.env}-${var.project}"
  tags = {
    Environment = var.env
    ManagedBy   = "Terraform"
  }
}

> local.name_prefix
"dev-myapp"
> local.tags
{
  "Environment" = "dev"
  "ManagedBy" = "Terraform"
}

# 文字列操作
> upper("ap-northeast-1")
"AP-NORTHEAST-1"

> replace("my-bucket-dev", "dev", "prod")
"my-bucket-prod"

> substr("terraform-console", 0, 9)
"terraform"

> split("-", "ap-northeast-1")
tolist([
  "ap",
  "northeast",
  "1",
])

# 数値操作
> max(10, 50, 30)
50

> length(["a", "b", "c"])
3

# cidrsubnet(prefix, newbits, netnum)
# 10.0.0.0/16 を /24 に分割したとき、インデックス 0 のサブネット
> cidrsubnet("10.0.0.0/16", 8, 0)
"10.0.0.0/24"

# インデックス 1 のサブネット
> cidrsubnet("10.0.0.0/16", 8, 1)
"10.0.1.0/24"

# インデックス 2 のサブネット（ap-northeast-1c 用など）
> cidrsubnet("10.0.0.0/16", 8, 2)
"10.0.2.0/24"

# cidrhost でサブネット内の特定ホストのIPを計算
> cidrhost("10.0.1.0/24", 10)
"10.0.1.10"

> jsonencode({
    Version = "2012-10-17"
    Statement = [
      {
        Effect   = "Allow"
        Action   = "s3:GetObject"
        Resource = "arn:aws:s3:::my-bucket/*"
      }
    ]
  })
"{\"Statement\":[{\"Action\":\"s3:GetObject\",\"Effect\":\"Allow\",\"Resource\":\"arn:aws:s3:::my-bucket/*\"}],\"Version\":\"2012-10-17\"}"

# user_data.sh.tpl が存在する場合
> templatefile("user_data.sh.tpl", {
    region  = var.region
    bucket  = "my-config-bucket"
  })
"#!/bin/bash\naws s3 cp s3://my-config-bucket/setup.sh /tmp/setup.sh --region ap-northeast-1\nbash /tmp/setup.sh\n"

# 変数 env が "prod" かどうかで instance_type を切り替える条件式
> var.env == "prod" ? "t3.large" : "t3.micro"
"t3.micro"

# 複合条件：env が prod かつ region が東京の場合
> (var.env == "prod" && var.region == "ap-northeast-1") ? "m5.xlarge" : "t3.micro"
"t3.micro"

# null チェック
> var.custom_ami != null ? var.custom_ami : "ami-0d3a0b0e1b8f1e3b1"
"ami-0d3a0b0e1b8f1e3b1"

# リストをマップに変換（for 式）
> {for s in ["ap-northeast-1a", "ap-northeast-1c", "ap-northeast-1d"] : s => true}
{
  "ap-northeast-1a" = true
  "ap-northeast-1c" = true
  "ap-northeast-1d" = true
}

# リスト要素をフィルタリング
> [for s in ["web", "app", "db"] : s if s != "db"]
[
  "web",
  "app",
]

# マップのキーだけを取り出す
> keys({a = 1, b = 2, c = 3})
[
  "a",
  "b",
  "c",
]

# リストの各要素を大文字に変換
> [for s in ["web", "app"] : upper(s)]
[
  "WEB",
  "APP",
]

# main.tf に data "aws_vpc" "main" {} が定義済みで state にある場合
> data.aws_vpc.main.id
"vpc-0a1b2c3d4e5f67890"

> data.aws_vpc.main.cidr_block
"10.0.0.0/16"

# 対処: var-file を指定して起動
$ terraform console -var-file=dev.tfvars