Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Terraform やるなら公式スタイルガイドを読もう 〜重要項目 10選〜
Search
hiyanger
August 02, 2025
Programming
14
3.4k
Terraform やるなら公式スタイルガイドを読もう 〜重要項目 10選〜
2026/8/2 栃木ゆる勉強会
https://tochigi-study.connpass.com/event/352995/
オフライン / 20名程度
hiyanger
August 02, 2025
Tweet
Share
More Decks by hiyanger
See All by hiyanger
(Amazon Bedrock 基礎)生成 AI の活用に導くシステム構築の基本とセキュリティの実装
hiyanger
4
91
CIer に在籍した 3年間 でやったこと
hiyanger
2
190
これからクラウドエンジニアになるために本当に必要なスキル 5選
hiyanger
1
700
クラウド食堂とは?
hiyanger
0
280
Amazon ECS とマイクロサービスから考えるシステム構成
hiyanger
2
1.1k
全身全霊で取り組んだ 2024 Qiita アドベントカレンダー
hiyanger
0
71
Terraform で作る Amazon ECS の CI/CD パイプライン
hiyanger
1
320
【AWS】EC2 基本アーキテクチャ(ハンズオン付き)
hiyanger
0
130
もういっそ AWS できなくても AWS できるようになるシステム作った
hiyanger
3
330
Other Decks in Programming
See All in Programming
ててべんす独演会〜Flowの全てを語ります〜
tbsten
1
220
ソフトウェア設計の実践的な考え方
masuda220
PRO
2
210
iOSアプリの信頼性を向上させる取り組み/ios-app-improve-reliability
shino8rayu9
0
130
Pull-Requestの内容を1クリックで動作確認可能にするワークフロー
natmark
1
410
AI Coding Meetup #3 - 導入セッション / ai-coding-meetup-3
izumin5210
0
110
そのpreloadは必要?見過ごされたpreloadが技術的負債として爆発した日
mugitti9
2
2.8k
uniqueパッケージの内部実装を支えるweak pointerの話
magavel
0
880
タスクの特性や不確実性に応じた最適な作業スタイルの選択(ペアプロ・モブプロ・ソロプロ)と実践 / Optimal Work Style Selection: Pair, Mob, or Solo Programming.
honyanya
2
110
半自動E2Eで手っ取り早くリグレッションテストを効率化しよう
beryu
6
2.4k
Web Components で実現する Hotwire とフロントエンドフレームワークの橋渡し / Bridging with Web Components
da1chi
2
1.5k
Advance Your Career with Open Source
ivargrimstad
0
250
階層構造を表現するデータ構造とリファクタリング 〜1年で10倍成長したプロダクトの変化と課題〜
yuhisatoxxx
3
860
Featured
See All Featured
Embracing the Ebb and Flow
colly
88
4.8k
Practical Tips for Bootstrapping Information Extraction Pipelines
honnibal
PRO
23
1.5k
No one is an island. Learnings from fostering a developers community.
thoeni
21
3.5k
The Illustrated Children's Guide to Kubernetes
chrisshort
48
51k
10 Git Anti Patterns You Should be Aware of
lemiorhan
PRO
657
61k
Building a Modern Day E-commerce SEO Strategy
aleyda
43
7.7k
Building an army of robots
kneath
306
46k
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
234
17k
Intergalactic Javascript Robots from Outer Space
tanoku
273
27k
The Pragmatic Product Professional
lauravandoore
36
6.9k
Git: the NoSQL Database
bkeepers
PRO
431
66k
Bootstrapping a Software Product
garrettdimon
PRO
307
110k
Transcript
Terraform 使うなら 公式スタイルガイドを読もう 〜重要項目 10選〜
自己紹介 名前 / 檜山 準(ひやんが) 職種 / AWS エンジニア (CIer
所属) 出身 / 栃木県 趣味 / ギター 🎸 @hiyanger
もくじ ※ Terraform とは ※ スタイルガイドとは 1. フォーマットしよう 2. ファイル名
3. Linter を使う 4. リソースの命名 5. リソース記述順 6. .gitignore への追加 7. バージョンの固定 8. モジュールの作り方 9. ディレクトリ構成 10. state の取り扱い
Terraformと スタイルガイド
Terraformとは シンプルな コード化が できる!!
スタイルガイドとは Terraformの利用における ベストプラクティスが書かれた資料! v1.12 のお話しです! ※スタイルガイド外の補足マーク→
スタイルガイド 10選!
1. フォーマットする gitへ push する前に terraform fmt (-recursive)
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行くらいが目安。 接続はスネークケース
3. Linterを使う tflint を導入して tflint
4. リソースの命名 NG resource aws_instance webAPI- aws-instance {...} OK resource
"aws_instance" "web_api" {...} 🙅 リソースタイプは含めない
5. リソース記述順 読みやすさ(依存関係)だけを考慮して並べる! (ビルド方法には影響しない)
6. .gitignore への追加 .terraform 配下 .tfstate 関連 .terraform.tfstate.lock.info .tfvars .terraform.lock.hcl
は プロバイダ固定のため除外しない!
7. バージョンの固定 provider と terraform は固定させておく! (チームで共有)
8. モジュールの作り方 リソースのグループ化を意識する! (大きすぎず、小さすぎず)
9 .(みんな大好き)ディレクトリ構成 main.tf → ファイル分割 → modulesの利用 → 環境分岐(prd/dev)→ state
分 割 スタイルガイドの言及部分 この仕組みだけ頭にいれておけばOK!
10. ステートファイルの取り扱い ‼ ステートファイルはシークレット情報を含むため共有しない 通常シークレット情報を使ってリソースをデプロイすると、 ステートに記録されてしまうが、v1.10で追加された write-only attributes(wo) を使うと回避できる! プロバイダ依存なとこだけ注意
まとめ
まとめ 1. フォーマットしよう → terraform fmt(-recursive) 2. ファイル名 → main
からすこずつ粒度を小さくする 3. Linter を使う → tflint 4. リソースの命名 → リソースタイプいれない & スネークケース 5. リソース記述順 → 依存順に上から 6. .gitignore への追加 → state 関連 7. バージョンの固定 → provider と terraform 8. モジュールの作り方 → リソースのグループ化を意識する 9. ディレクトリ構成 → 基本はmoduleで必要なら環境分岐 10. state の取り扱い → 共有しない(woで回避できる)
参考 ・モジュール 推奨パターン 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