IaC Playbook

An opinionated guide to writing, structuring, and operating Infrastructure-as-Code at scale. The playbook covers naming conventions, module design, state management, secret handling, CI/CD pipelines, and day-two operations across cloud providers.

Each section is self-contained and actionable. Start with the topic most relevant to your current work, or read sequentially to build a complete mental model.

Contents

Section	Description
Decision Guide	Choosing between Terraform and Ansible, and how to combine them
Terraform	Naming conventions, backends, module structure, providers, variables, secrets, workflow, CI/CD pipelines, and lifecycle rules
Ansible	Project structure, naming conventions, module design, state management, variables, anti-patterns, CI/CD pipelines, and security