# azure/alz-terraform-accelerator architecture

> Architecture diagram of the GitHub repository azure/alz-terraform-accelerator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azure/alz-terraform-accelerator
- Repository: https://github.com/azure/alz-terraform-accelerator

## Overview

This repository provides Terraform starter templates for deploying Azure Landing Zones. The main workflow is for an engineer to configure the platform landing-zone template, choose management and connectivity options, and apply it to create Azure resources. The tree also shows an empty starter, a test template, and custom architecture and archetype definitions. Source excerpts were not available, so the graph reflects documented product purpose and tree-supported responsibilities; detailed module wiring and resource dependencies are omitted.

Main entry points: [`templates/platform_landing_zone`](https://github.com/azure/alz-terraform-accelerator/tree/main/templates/platform_landing_zone) (Platform landing zone), [`templates/empty`](https://github.com/azure/alz-terraform-accelerator/tree/main/templates/empty) (Empty starter), [`templates/test`](https://github.com/azure/alz-terraform-accelerator/tree/main/templates/test) (Test template), [`templates/platform_landing_zone/modules/config-templating`](https://github.com/azure/alz-terraform-accelerator/tree/main/templates/platform_landing_zone/modules/config-templating) (Config templating)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_templates["Terraform templates"]
  node_platform["Platform landing zone"]
  node_empty["Empty starter"]
  node_test["Test template"]
end

subgraph group_configuration["Configuration library"]
  node_config["Config templating"]
  node_library["Library definitions"]
end

subgraph group_deployment["Landing zone deployment"]
  node_management["Management groups"]
  node_management_resources["Management resources"]
  node_resource_groups["Resource groups"]
  node_hub_spoke["Hub-and-spoke networking"]
  node_virtual_wan["Virtual WAN networking"]
  node_outputs["Deployment outputs<br/>[outputs.tf]"]
end

subgraph group_external["External platform"]
  node_azure{{"Microsoft Azure"}}
end

node_engineer(("Infrastructure engineer"))

node_engineer -->|"configures"| node_platform
node_engineer -->|"starts from"| node_empty
node_engineer -->|"uses example"| node_test
node_platform -->|"uses configuration"| node_config
node_platform -->|"loads definitions"| node_library
node_platform -->|"deploys groups"| node_management
node_platform -->|"deploys resources"| node_management_resources
node_platform -->|"creates groups"| node_resource_groups
node_platform -->|"offers topology"| node_hub_spoke
node_platform -->|"offers topology"| node_virtual_wan
node_platform -->|"provisions infrastructure"| node_azure
node_platform -->|"exposes results"| node_outputs

click node_platform "https://github.com/azure/alz-terraform-accelerator/tree/main/templates/platform_landing_zone"
click node_empty "https://github.com/azure/alz-terraform-accelerator/tree/main/templates/empty"
click node_test "https://github.com/azure/alz-terraform-accelerator/tree/main/templates/test"
click node_config "https://github.com/azure/alz-terraform-accelerator/tree/main/templates/platform_landing_zone/modules/config-templating"
click node_library "https://github.com/azure/alz-terraform-accelerator/tree/main/templates/platform_landing_zone/lib"
click node_management "https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/main.management.groups.tf"
click node_management_resources "https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/main.management.resources.tf"
click node_resource_groups "https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/main.resource.groups.tf"
click node_hub_spoke "https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/main.connectivity.hub.and.spoke.virtual.network.tf"
click node_virtual_wan "https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/main.connectivity.virtual.wan.tf"
click node_outputs "https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/outputs.tf"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_platform,node_empty,node_test toneBlue
class node_config,node_library toneAmber
class node_management,node_management_resources,node_resource_groups,node_hub_spoke,node_virtual_wan,node_outputs toneMint
class node_azure toneRose
class node_engineer toneIndigo
```

## Components

### Terraform templates

- [Platform landing zone](https://github.com/azure/alz-terraform-accelerator/tree/main/templates/platform_landing_zone): `templates/platform_landing_zone`
- [Empty starter](https://github.com/azure/alz-terraform-accelerator/tree/main/templates/empty): `templates/empty`
- [Test template](https://github.com/azure/alz-terraform-accelerator/tree/main/templates/test): `templates/test`

### Configuration library

- [Config templating](https://github.com/azure/alz-terraform-accelerator/tree/main/templates/platform_landing_zone/modules/config-templating): `templates/platform_landing_zone/modules/config-templating`
- [Library definitions](https://github.com/azure/alz-terraform-accelerator/tree/main/templates/platform_landing_zone/lib): `templates/platform_landing_zone/lib`

### Landing zone deployment

- [Management groups](https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/main.management.groups.tf): `templates/platform_landing_zone/main.management.groups.tf`
- [Management resources](https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/main.management.resources.tf): `templates/platform_landing_zone/main.management.resources.tf`
- [Resource groups](https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/main.resource.groups.tf): `templates/platform_landing_zone/main.resource.groups.tf`
- [Hub-and-spoke networking](https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/main.connectivity.hub.and.spoke.virtual.network.tf): `templates/platform_landing_zone/main.connectivity.hub.and.spoke.virtual.network.tf`
- [Virtual WAN networking](https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/main.connectivity.virtual.wan.tf): `templates/platform_landing_zone/main.connectivity.virtual.wan.tf`
- [Deployment outputs](https://github.com/azure/alz-terraform-accelerator/blob/main/templates/platform_landing_zone/outputs.tf): `templates/platform_landing_zone/outputs.tf`

### External platform

- **Microsoft Azure**

### Other components

- **Infrastructure engineer**

## Connections

- Infrastructure engineer → Platform landing zone: configures
- Infrastructure engineer → Empty starter: starts from
- Infrastructure engineer → Test template: uses example
- Platform landing zone → Config templating: uses configuration
- Platform landing zone → Library definitions: loads definitions
- Platform landing zone → Management groups: deploys groups
- Platform landing zone → Management resources: deploys resources
- Platform landing zone → Resource groups: creates groups
- Platform landing zone → Hub-and-spoke networking: offers topology
- Platform landing zone → Virtual WAN networking: offers topology
- Platform landing zone → Microsoft Azure: provisions infrastructure
- Platform landing zone → Deployment outputs: exposes results