Terragruntとは？Terraformをもっと便利にする相棒についてわかりやすくご紹介！

未分類

インフラをコードで管理する「IaC（Infrastructure as Code）」は、AWSやGCPを扱うエンジニアにとって欠かせない考え方になっています。その代表格がTerraform。私も初めてTerraformを使ったときは、数行のコードからEC2を立ち上げられるのに感動しました。

ですが、実際のプロジェクトでは「環境ごとの変数管理が大変」「モジュールをたくさん作るとコードが散らばる」「ステート管理が複雑」といった課題にぶつかります。
そこで登場するのがTerragruntです。

Table of Contents

Terragruntの概要

Terragruntは、Terraformをラップして便利に使えるようにするツールです。Terraform自体を置き換えるものではなく、「Terraformの上にかぶせる追加ツール」と考えると分かりやすいです。

特に役立つのは以下のようなポイントです。

つまり、Terraform単体では「小さな構築」には十分ですが、チーム開発や大規模インフラではTerragruntを併用したほうが運用が楽になるというわけです。

まずTerraformだけでシンプルにEC2を立ち上げる例です。

provider "aws" {
  region = "ap-northeast-1"
}

resource "aws_instance" "example" {
  ami           = "ami-12345678"
  instance_type = "t2.micro"
}

このコードを main.tf に書いて、

terraform init
terraform apply

すればEC2が立ち上がります。とても簡単ですが、もし dev 用と prod 用に別々のインスタンスを作りたい場合、変数ファイルを分けたり、コードをコピペして書き換えたりする必要が出てきます。

Terragruntを導入すると、共通部分はモジュール化し、環境ごとの設定は terragrunt.hcl に切り分けられます。

例として「EC2を立ち上げるモジュール」を作り、それを dev と prod で使い分けてみます。

variable "instance_type" {}
variable "ami" {}

resource "aws_instance" "this" {
  ami           = var.ami
  instance_type = var.instance_type
}

terraform {
  source = "../../../modules/ec2"
}

inputs = {
  instance_type = "t2.micro"
  ami           = "ami-12345678"
}

terraform {
  source = "../../../modules/ec2"
}

inputs = {
  instance_type = "t3.medium"
  ami           = "ami-87654321"
}

これで dev 環境では小さなEC2、prod 環境では大きめのEC2を簡単に切り替えてデプロイできます。

実行方法もシンプルです。

cd live/dev/ec2
terragrunt apply

これで dev 用のEC2が立ち上がります。prod に切り替えたいときは、live/prod/ec2 に移動して同じコマンドを打つだけです。

Terraformを「エンジン」、Terragruntを「効率的に運転するドライバー補助機能」とイメージすると理解しやすいと思います。

私自身、最初はTerraformだけで満足していましたが、プロジェクト規模が大きくなるほどTerragruntのありがたみを感じています。「環境の違いをコードにどう表現するか？」という課題に直面している方は、ぜひ一度Terragruntを試してみると良いでしょう。

最新情報をチェックしよう！