Architecture as Code · Whitepaper

Chapter 3 · Foundations

Version Control and Code Structure

Key insights from Chapter 3 of "Architecture as Code"

Author Gunnar Nordqvist
Published 23 October 2025
Build number 2025.10
diagram-refresh governance-automation ai-collaboration
Version Control and Code structure
Version Control and Code structure

Effective version control forms the backbone of Architecture as Code implementations. Applying the same practices as software development to infrastructure definitions delivers traceability, collaboration opportunities, and quality control.

The diagram illustrates the typical flow from a Git repository through branching strategy and code review to final deployment, ensuring controlled and traceable infrastructure development.

Git is the standard for version control of Architecture as Code assets and enables distributed collaboration between team members. Each change is documented with commit messages that describe what was modified and why, creating a complete history of infrastructure evolution.

Primary topics explored

  1. Git-based workflow for infrastructure
  2. Code organisation and module structure
  3. Mono-repo versus multi-repo topology
  4. Branching strategy
  5. Transparency through version control
  6. Summary

About Architecture as Code

Infrastructure as Code represents a fundamental change in how we manage and develop IT infrastructure. This book provides organisations with practical guidance for implementing IaC principles whilst fulfilling local compliance requirements and optimising costs.

The book covers everything from fundamental principles and tools to advanced implementation strategies, security aspects, and organisational changes required for successful IaC adoption.

Who should read this

IT architects, DevOps teams, developers, and decision-makers within organisations.

Portrait of Gunnar Nordqvist

Gunnar Nordqvist

Conceived, directed and published the books of The Transformed Architecture.

Continue with the full chapter

Read the full chapter online

Chapter 3: Version Control and Code Structure in Architecture as Code gives the detailed explanations, practical examples and implementation patterns behind this summary.

This whitepaper belongs to “Foundations” and is one of 38 drawn from the manuscript.