terraformの基本的な使い方
概要
- IaC(Infrastructure as Code)の一つ
- AWS, GCP, Azureなどのクラウドプロバイダーに対応
- HCL(HashiCorp Configuration Language)という独自の言語を使用
terraform applyを行うとterraform.tfstateというファイルが生成され、その中に現在の状態が保存されるterraform.tfstateはS3やGCSなどのリモートストレージに保存することが推奨
インストール
macOS
# brew では最新のバージョンがインストールされないため、tfenvを使用することを推奨
$ brew uninstall terraform
$ brew install tfenv
$ tfenv install latest
$ tfenv use latest
$ terraform -v
ubuntu
# 1. GPGキーを keyrings に登録（apt-key は非推奨のため使用しない）
$ sudo mkdir -p /etc/apt/keyrings
$ curl -fsSL https://apt.releases.hashicorp.com/gpg \
| sudo gpg --dearmor -o /etc/apt/keyrings/hashicorp.gpg
# 2. リポジトリを追加（Ubuntu のコードネームは /etc/os-release から取得）
$ source /etc/os-release
$ echo "deb [signed-by=/etc/apt/keyrings/hashicorp.gpg] \
https://apt.releases.hashicorp.com ${VERSION_CODENAME} main" \
| sudo tee /etc/apt/sources.list.d/hashicorp.list > /dev/null
# 3. パッケージリストを更新して Terraform をインストール
$ sudo apt-get update && sudo apt-get install -y terraform
基本的なコマンド
terraform init- 初期化terraform plan- 実行計画の確認terraform apply- 実行計画の適用terraform destroy- リソースの削除
gitでの管理
- 状態ファイルの管理
.gitignoreにterraform.tfstateとterraform.tfstate.backupを追加.gitignoreに.terraform/も追加（プラグインやキャッシュのディレクトリ）terraform.tfstateはリモートストレージに保存することが推奨されているため、リポジトリに保存する必要はない- 依存プロバイダの固定用
./.terraform.lock.hclは再現性のためコミットする
- 機密情報の管理
- 機密情報を含む
.tfvarsをリポジトリにコミットしない（.gitignoreに追記） - 代替として、環境変数
TF_VAR_foo=...を使う、あるいは各クラウドのシークレットマネージャーを使用 - 変数定義は
variable "foo" { sensitive = true }を用いて出力に漏れないようにする
- 機密情報を含む
gitで commit 前のチェック
formatの静的チェック
$ terraform fmt -recursive
$ terraform validate
よくある構成
repo/
envs/
dev/
main.tf
providers.tf
variables.tf # env固有の値（project_id, region, zone など）
backend.tf
versions.tf
terraform.tfvars # 任意: project_id 等をここに
modules/
network/
main.tf
variables.tf
outputs.tf
vm/
main.tf
variables.tf
outputs.tf