Terraform やるなら公式スタイルガイドを読もう 〜重要項目 10選〜

2026/8/2 栃木ゆる勉強会
https://tochigi-study.connpass.com/event/352995/

オフライン / 20名程度

Transcript

1. Terraform 使うなら 公式スタイルガイドを読もう 〜重要項目 10選〜
2. 自己紹介 名前 / 檜山 準（ひやんが） 職種 / AWS エンジニア （CIer 所属） 出身 / 栃木県 趣味 / ギター 🎸 @hiyanger
3. もくじ ※ Terraform とは ※ スタイルガイドとは 1. フォーマットしよう 2. ファイル名 3. Linter を使う 4. リソースの命名 5. リソース記述順 6. .gitignore への追加 7. バージョンの固定 8. モジュールの作り方 9. ディレクトリ構成 10. state の取り扱い
4. Terraformと スタイルガイド
5. Terraformとは シンプルな コード化が できる！！
6. スタイルガイドとは Terraformの利用における ベストプラクティスが書かれた資料！ v1.12 のお話しです！ ※スタイルガイド外の補足マーク→
7. スタイルガイド 10選！
8. 1. フォーマットする gitへ push する前に terraform fmt （-recursive）
9. 2. ファイル名 backend.tf main.tf outputs.tf provider.tf variables.tf network.tf storage.tf compute.tf network.tf security _group.tf alb.tf route53.tf 左のファイルを基本に行数が増えてきたら分割を検討。 100~200行くらいが目安。 接続はスネークケース
10. 3. Linterを使う tflint を導入して tflint
11. 4. リソースの命名 NG resource aws_instance webAPI- aws-instance {...} OK resource "aws_instance" "web_api" {...} 🙅 リソースタイプは含めない
12. 5. リソース記述順 読みやすさ（依存関係）だけを考慮して並べる！ （ビルド方法には影響しない）
13. 6. .gitignore への追加 .terraform 配下 .tfstate 関連 .terraform.tfstate.lock.info .tfvars .terraform.lock.hcl は 　プロバイダ固定のため除外しない！
14. 7. バージョンの固定 provider と terraform は固定させておく！ （チームで共有）
15. 8. モジュールの作り方 リソースのグループ化を意識する！ （大きすぎず、小さすぎず）
16. 9 .（みんな大好き）ディレクトリ構成 main.tf → ファイル分割 → modulesの利用 → 環境分岐（prd/dev）→ state 分 割 スタイルガイドの言及部分 この仕組みだけ頭にいれておけばOK！
17. 10. ステートファイルの取り扱い ‼ ステートファイルはシークレット情報を含むため共有しない 通常シークレット情報を使ってリソースをデプロイすると、 ステートに記録されてしまうが、v1.10で追加された write-only attributes（wo） を使うと回避できる！ プロバイダ依存なとこだけ注意
18. まとめ
19. まとめ 1. フォーマットしよう → terraform fmt（-recursive） 2. ファイル名 → main からすこずつ粒度を小さくする 3. Linter を使う → tflint 4. リソースの命名 → リソースタイプいれない & スネークケース 5. リソース記述順 → 依存順に上から 6. .gitignore への追加 → state 関連 7. バージョンの固定 → provider と terraform 8. モジュールの作り方 → リソースのグループ化を意識する 9. ディレクトリ構成 → 基本はmoduleで必要なら環境分岐 10. state の取り扱い → 共有しない（woで回避できる）
20. 参考 ・モジュール 推奨パターン 　 https://developer.hashicorp.com/terraform/tutorials/modules/pattern-module-creatio n ・モジュール 標準構造　 　https://developer.hashicorp.com/terraform/language/modules/develop/structure ・stateにシークレットを表示させない（Terraform v1.11） 　https://zenn.dev/terraform_jp/articles/tf-write-only-attributes