Terraform

概要

Terraform は、インフラ構成を HCL で記述し、クラウドリソースを宣言的に管理する IaC ツールです。このチートシートでは、CLI、リソース定義、変数、State、バックエンド、モジュール、ワークスペースの基本を整理します。

最初に覚える最小セット

Terraform は apply より先に plan の内容を読み、作成・変更・削除されるリソースを確認します。destroy と apply -auto-approve は、本番では原則としてレビュー済みの手順でのみ使います。

基本コマンド

リソース定義

resource "aws_instance" "web" {
 ami = "ami-0c55b159cbfafe1f0"
 instance_type = "t3.micro"

 tags = {
 Name = "web-server"
 Env = "production"
 }
}

変数

variable "instance_count" {
 description = "Number of instances"
 type = number
 default = 2
}

resource "aws_instance" "app" {
 count = var.instance_count
 ami = "ami-123456"
 instance_type = "t3.micro"
}

出力値

output "web_public_ip" {
 description = "Public IP of web server"
 value = aws_instance.web.public_ip
}

データソース

data "aws_ami" "ubuntu" {
 most_recent = true
 owners = ["099720109477"]

 filter {
 name = "name"
 values = ["ubuntu/images/hvm-ssd/ubuntu-*-22.04-amd64-server-*"]
 }
}

resource "aws_instance" "web" {
 ami = data.aws_ami.ubuntu.id
}

State 管理

バックエンド設定

terraform {
 backend "s3" {
 bucket = "my-terraform-state"
 key = "prod/terraform.tfstate"
 region = "us-east-1"
 dynamodb_table = "terraform-lock"
 encrypt = true
 }
}

モジュール

module "web_server" {
 source = "./modules/ec2"

 instance_type = "t3.small"
 ami = "ami-123456"
 subnet_id = module.vpc.public_subnet_id
}

output "web_ip" {
 value = module.web_server.public_ip
}

ワークスペース

ワークスペース別設定の例:

resource "aws_instance" "web" {
 ami = "ami-123456"
 instance_type = terraform.workspace == "prod" ? "t3.large" : "t3.micro"

 tags = {
 Environment = terraform.workspace
 }
}

よく使う関数

まとめ

Terraform では、init、fmt、validate、plan、apply の順番を守ることが基本です。State はインフラの実態と Terraform の対応関係を持つ重要ファイルなので、ローカル管理ではなくリモート backend とロックを使う運用を優先します。

destroy、State 操作、workspace 切り替えは影響が大きいため、対象環境と plan を確認してから実行してください。

参考リソース

• Terraform CLI Reference - コマンド公式リファレンス
• Terraform Language - HCL 文法
• Terraform Registry - プロバイダとモジュールのレジストリ
• Best Practices - 公式ベストプラクティス

関連記事

• Ansible チートシート - 構成管理ツールのリファレンス

×

PR

×

PR