こんにちは。技術ブログ運営の伊藤です。

今年もフューチャー技術ブログでは、Terraformを題材とした連載を開催します。今回は8人の方が参加します。

Terraform連載は2023年から始まり、4年連続の開催となります。技術カットの連載企画の中では比較的ご長寿連載になりました。

• Terraform連載2023
• Terraform連載2024
• Terraform連載2025

この記事では、昨年のTerraform連載2025以降にリリースされたv1.12からこのブログの公開日の少し前にリリースされたv1.15までの新機能に触れます。

バージョン別変更点一覧

v1.12からv1.15までのまとめを生成AIに作ってもらいました。特に、ここでは新機能と機能改善について着目します。

一通り眺めてみると、これまではTerraformでリソースを作るときにフォーカスされる機能が多い印象でしたが、よりテスト、その後の保守性まで踏まえたバージョンアップをしているように感じました。

気になる機能

ここからは特に私が気になった機能について、2つほどピックアップしました。

v1.12: terraform testコマンドで-parallelism=nフラグが利用可能になった

これまで、Terraformのplanコマンドやapplyコマンドで使えたparallelismのフラグがtestコマンドでも使うことができるようになりました。このフラグは、Terraformのそれぞれのコマンドを実行するときの並列度を調整でき、デフォルト値はplanコマンドやapplyコマンドと同様に10に設定されています¹。

ユースケースとしては、あるTerraformでの管理対象が増大したときにparallelismのフラグをつけることで、それなりに高速化させることが可能です。ただ、高速化する一方、その管理対象の粒度が適切でない場合（数百のリソースになる場合）はリファクタリングも視野に入れましょう。

v1.14: terraform queryコマンドを利用してリスト操作の実行、結果から import 用設定の自動生成が可能になった

v1.5でimportブロックがサポートされ、複数のリソースを.tfファイルに定義してCI/CD上でリソースのインポートが可能でした。しかしながらインポートする対象のリソースはものによってはIDであったり、ARNであったり定義するべきものが異なります。そのためimportブロックの記述は煩雑なものでした。

ここで、v1.14で新たに使えるようになったterraform queryコマンドを使うことでソース記述のハードルがグッと下がりました。

例えば、EC2インスタンスを手動で立てたのち、取り込みたい場合においては以下のようなlistブロックを.tfquery.hclファイルに記載します。

list "aws_instance" "development" {
  provider = aws
}

resourceブロックに対応するリソース（今回はaws_instance）を記述することで、Terraformで管理されている、されていないに関わらず一覧化できます。実際にterraform queryコマンドを実行すると、以下のようにlistブロックで定義したリソースの一覧を取得できます。

$ terraform query
list.aws_instance.development   account_id=123456789012,id=i-xxxxxx,region=ap-northeast-1   dev-instance (i-xxxxxx)
list.aws_instance.development   account_id=123456789012,id=i-yyyyyy,region=ap-northeast-1   query-test-instance (i-yyyyyy)

また、特定の範囲に絞りたい場合にはタグなどで絞ることができ、例としてNameタグで絞ると以下のような書き方になり、1行目のリソースのみ抽出できます。

list "aws_instance" "development" {
  provider = aws

  config {
    filter {
      name   = "tag:Name"
      values = ["dev-instance"]
    }
  }
}

対象のリソースを選択した後はterraform queryコマンドに-generate-config-outオプションを指定して実行すれば、resourceブロックとimportブロックを自動生成してくれます（今回はconfigブロックがない状態で生成しました）。

# __generated__ by Terraform
# Please review these resources and move them into your main configuration files.

# __generated__ by Terraform
resource "aws_instance" "development_0" {
  provider   = aws
  ...
  private_ip = "10.0.2.92"
  region     = "ap-northeast-1"
  tags = {
    Name = "dev-instance"
  }
  ...
}

import {
  to       = aws_instance.development_0
  provider = aws
  identity = {
    account_id = "123456789012"
    id         = "i-xxxxxx"
    region     = "ap-northeast-1"
  }
}

resource "aws_instance" "development_1" {
  provider   = aws
  ...
  private_ip = "10.0.2.228"
  region     = "ap-northeast-1"
  tags = {
    Name = "query-test-instance"
  }
  ...
}

import {
  to       = aws_instance.development_1
  provider = aws
  identity = {
    account_id = "123456789012"
    id         = "i-yyyyyy"
    region     = "ap-northeast-1"
  }
}

後は生成されたソースを期待する状態に修正、配置することでTerraformでの管理が可能となります。

さいごに

改めて直近のリリースノートを読み返して機能を触ってみましたが、着実に機能追加がされており、便利な関数も増えたことで、運用・エンハンスという観点でも便利になっていることを感じました。

この連載で社内のいろんな知見が公開されるのでぜひ皆さんも楽しみにしていただけると幸いです。

引き続き、よろしくお願いします。