Infrastructure

Practical guidance for provisioning and managing cloud infrastructure with Terraform at Synapse Studios

Related Concepts: Infrastructure Concepts | Coupling and Cohesion | Continuous Delivery | Deploying to AWS ECS

Overview

Our infrastructure is managed as code using Terraform. These guides capture a mix of industry best practices and organizational preferences developed over many years of working with Terraform across projects of all sizes, from early-stage startups to large enterprise environments.

Guides

Each guide describes what to do. The reasoning behind it lives in the paired concept article.

• Project Structure covers the folder layout, the root modules inside each account, file conventions, deployment order, and how to connect root modules through remote state. Reasoning: Terraform State Boundaries.
• Module Design covers module interfaces, data-only modules, and the tagging strategy. Reasoning: Terraform Module Philosophy.
• Testing covers the four test levels, what to assert on, writing unit and integration tests, and how CI runs each level. Reasoning: Terraform Change Control.
• Orchestration covers the TACOS workflow, the obligations that come with applying pre-merge, bootstrapping, manual intervention, anti-patterns, and the mechanisms that keep drift out. Reasoning: Terraform Change Control.