# azure/terraform-azurerm-avm-ptn-alz architecture

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

- Interactive diagram: https://gitdiagram.com/azure/terraform-azurerm-avm-ptn-alz
- Repository: https://github.com/azure/terraform-azurerm-avm-ptn-alz

## Overview

This is a Terraform module for deploying Azure Landing Zones. A consumer supplies architecture and configuration; the ALZ provider reads architecture data, and the module provisions management hierarchy, policy assets, and access-related resources in Azure through AzAPI. Policy assignment customization, subscription placement, hierarchy settings, and telemetry are also represented. The README documents these capabilities and resources, but no source excerpts were available, so internal call wiring is kept conservative.

Main entry points: [`main.tf`](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.tf) (ALZ module), [`terraform.tf`](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/terraform.tf) (ALZ data provider), [`main.hierarchy_settings.tf`](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.hierarchy_settings.tf) (Hierarchy settings), [`main.management_groups.tf`](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.management_groups.tf) (Management groups)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Configuration"]
  node_module["ALZ module<br/>[main.tf]"]
  node_inputs["Architecture inputs<br/>[variables.tf]"]
  node_alz_provider["ALZ data provider<br/>[terraform.tf]"]
end

subgraph group_hierarchy["Management hierarchy"]
  node_hierarchy_settings["Hierarchy settings"]
  node_management_groups["Management groups"]
  node_subscription_placement["Subscription placement"]
end

subgraph group_policies["Policy deployment"]
  node_policy_definitions["Policy definitions"]
  node_policy_sets["Policy initiatives"]
  node_policy_assignments["Policy assignments"]
  node_policy_customization["Assignment changes"]
end

subgraph group_access_telemetry["Access and telemetry"]
  node_role_definitions["Custom role definitions"]
  node_role_assignments["Role assignments"]
  node_policy_role_assignments["Policy role grants"]
  node_telemetry["Telemetry<br/>[main.telemetry.tf]"]
end

node_consumer(("Module consumer"))
node_azure["Azure APIs"]

node_consumer -->|"configures"| node_module
node_module -->|"accepts inputs"| node_inputs
node_module -->|"reads architecture"| node_alz_provider
node_alz_provider -->|"reads data"| node_azure
node_hierarchy_settings -->|"manages settings"| node_azure
node_management_groups -->|"creates groups"| node_azure
node_subscription_placement -->|"places subscriptions"| node_azure
node_policy_definitions -->|"deploys definitions"| node_azure
node_policy_sets -->|"deploys initiatives"| node_azure
node_policy_assignments -->|"deploys assignments"| node_azure
node_policy_customization -->|"modifies assignments"| node_azure
node_role_definitions -->|"deploys roles"| node_azure
node_role_assignments -->|"creates grants"| node_azure
node_policy_role_assignments -->|"grants permissions"| node_azure
node_telemetry -->|"records telemetry"| node_azure

click node_module "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.tf"
click node_inputs "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/variables.tf"
click node_alz_provider "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/terraform.tf"
click node_hierarchy_settings "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.hierarchy_settings.tf"
click node_management_groups "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.management_groups.tf"
click node_subscription_placement "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.subscription_placement.tf"
click node_policy_definitions "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.policy_definitions.tf"
click node_policy_sets "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.policy_set_definitions.tf"
click node_policy_assignments "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.policy_assignments.tf"
click node_policy_customization "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.policy_assignments.tf"
click node_role_definitions "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.role_definitions.tf"
click node_role_assignments "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.role_assignments.tf"
click node_policy_role_assignments "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.policy_role_assignments.tf"
click node_telemetry "https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.telemetry.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_module,node_inputs,node_alz_provider toneBlue
class node_hierarchy_settings,node_management_groups,node_subscription_placement toneAmber
class node_policy_definitions,node_policy_sets,node_policy_assignments,node_policy_customization,node_azure toneMint
class node_role_definitions,node_role_assignments,node_policy_role_assignments,node_telemetry toneRose
class node_consumer toneIndigo
```

## Components

### Configuration

- [ALZ module](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.tf): `main.tf`
- [Architecture inputs](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/variables.tf): `variables.tf`
- [ALZ data provider](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/terraform.tf): `terraform.tf`

### Management hierarchy

- [Hierarchy settings](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.hierarchy_settings.tf): `main.hierarchy_settings.tf`
- [Management groups](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.management_groups.tf): `main.management_groups.tf`
- [Subscription placement](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.subscription_placement.tf): `main.subscription_placement.tf`

### Policy deployment

- [Policy definitions](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.policy_definitions.tf): `main.policy_definitions.tf`
- [Policy initiatives](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.policy_set_definitions.tf): `main.policy_set_definitions.tf`
- [Policy assignments](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.policy_assignments.tf): `main.policy_assignments.tf`
- [Assignment changes](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.policy_assignments.tf): `main.policy_assignments.tf`

### Access and telemetry

- [Custom role definitions](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.role_definitions.tf): `main.role_definitions.tf`
- [Role assignments](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.role_assignments.tf): `main.role_assignments.tf`
- [Policy role grants](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.policy_role_assignments.tf): `main.policy_role_assignments.tf`
- [Telemetry](https://github.com/azure/terraform-azurerm-avm-ptn-alz/blob/main/main.telemetry.tf): `main.telemetry.tf`

### Other components

- **Module consumer**
- **Azure APIs**

## Connections

- Module consumer → ALZ module: configures
- ALZ module → Architecture inputs: accepts inputs
- ALZ module → ALZ data provider: reads architecture
- ALZ data provider → Azure APIs: reads data
- Hierarchy settings → Azure APIs: manages settings
- Management groups → Azure APIs: creates groups
- Subscription placement → Azure APIs: places subscriptions
- Policy definitions → Azure APIs: deploys definitions
- Policy initiatives → Azure APIs: deploys initiatives
- Policy assignments → Azure APIs: deploys assignments
- Assignment changes → Azure APIs: modifies assignments
- Custom role definitions → Azure APIs: deploys roles
- Role assignments → Azure APIs: creates grants
- Policy role grants → Azure APIs: grants permissions
- Telemetry → Azure APIs: records telemetry
