# azure/enterprise-scale architecture

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

- Interactive diagram: https://gitdiagram.com/azure/enterprise-scale
- Repository: https://github.com/azure/enterprise-scale

## Overview

This repository provides Azure Landing Zones (Enterprise-Scale) reference implementations: prescriptive, modular infrastructure-as-code for establishing a multi-subscription Azure environment and scaling it through landing zones. The documented user journey is to select a deployment scenario, use the portal or infrastructure templates to establish foundational architecture, and apply governance and operational recommendations. The tree includes ARM templates, policy definitions and assignments, and PowerShell tooling; because no source excerpts are available, relationships below are limited to capabilities and deployment options explicitly described in the README.

Main entry points: [`eslzArm`](https://github.com/azure/enterprise-scale/tree/main/eslzArm) (ARM implementation), [`eslzArm/managementGroupTemplates/policyDefinitions/policies.json`](https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/policyDefinitions/policies.json) (Policy definitions), [`eslzArm/managementGroupTemplates/policyAssignments`](https://github.com/azure/enterprise-scale/tree/main/eslzArm/managementGroupTemplates/policyAssignments) (Policy assignments), [`src/resources/Microsoft.Authorization/policyDefinitions`](https://github.com/azure/enterprise-scale/tree/main/src/resources/Microsoft.Authorization/policyDefinitions) (Policy library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deployment["Deployment options"]
  node_portal["Portal experience"]
  node_armroot["ARM implementation"]
  node_samples["Scenario examples"]
end

subgraph group_foundation["Platform foundation"]
  node_prereqs["Deployment prerequisites"]
  node_mgstructure["Management groups<br/>[mgmtGroups.json]"]
  node_subscriptionorg["Subscription organization"]
  node_network["Connectivity templates"]
  node_resource_templates["Resource templates"]
end

subgraph group_governance["Governance and security"]
  node_policy_defs["Policy definitions<br/>[policies.json]"]
  node_policy_sets["Policy initiatives<br/>[initiatives.json]"]
  node_policy_assignments["Policy assignments"]
  node_role_assignments["Role assignments"]
  node_custom_roles["Custom roles"]
  node_policy_library["Policy library<br/>[policyDefinitions]"]
end

subgraph group_operations["Operations"]
  node_alz_tools["ALZ PowerShell tools<br/>[Alz.Tools.ps1]"]
  node_diagnostics["Diagnostics templates"]
  node_subscriptions[("Azure subscriptions")]
end

node_customer(("Azure adopter"))

node_customer -->|"deploys through"| node_portal
node_customer -->|"deploys with"| node_armroot
node_customer -->|"selects scenario"| node_samples
node_armroot -->|"provisions landing zones"| node_subscriptions
node_armroot -->|"supports multi-subscription design"| node_mgstructure
node_armroot -->|"includes policy IaC"| node_policy_defs
node_armroot -->|"configures platform services"| node_network
node_armroot -.->|"includes prerequisites"| node_prereqs
node_armroot -.->|"organizes subscriptions"| node_subscriptionorg
node_armroot -.->|"provides resource templates"| node_resource_templates
node_policy_defs -->|"governs through"| node_policy_assignments
node_policy_defs -.->|"supports policy governance"| node_policy_sets
node_policy_library -.->|"enables guardrails"| node_policy_assignments
node_armroot -->|"supports access management"| node_role_assignments
node_armroot -.->|"supports access management"| node_custom_roles
node_armroot -->|"supports logging"| node_diagnostics
node_alz_tools -.->|"supports automation"| node_armroot

click node_portal "https://github.com/azure/enterprise-scale/tree/main/src/portal"
click node_armroot "https://github.com/azure/enterprise-scale/tree/main/eslzArm"
click node_samples "https://github.com/azure/enterprise-scale/tree/main/examples"
click node_prereqs "https://github.com/azure/enterprise-scale/blob/main/eslzArm/prerequisites/deployPrerequisites.json"
click node_mgstructure "https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/mgmtGroupStructure/mgmtGroups.json"
click node_subscriptionorg "https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/subscriptionOrganization/subscriptionOrganization.json"
click node_network "https://github.com/azure/enterprise-scale/blob/main/eslzArm/subscriptionTemplates/hubspoke-connectivity.json"
click node_resource_templates "https://github.com/azure/enterprise-scale/tree/main/eslzArm/resourceGroupTemplates"
click node_policy_defs "https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/policyDefinitions/policies.json"
click node_policy_sets "https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/policyDefinitions/initiatives.json"
click node_policy_assignments "https://github.com/azure/enterprise-scale/tree/main/eslzArm/managementGroupTemplates/policyAssignments"
click node_role_assignments "https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/roleAssignments/roleAssignment.json"
click node_custom_roles "https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/roleDefinitions/customRoleDefinitions.json"
click node_policy_library "https://github.com/azure/enterprise-scale/tree/main/src/resources/Microsoft.Authorization/policyDefinitions"
click node_alz_tools "https://github.com/azure/enterprise-scale/blob/main/src/Alz.Tools/functions/Alz.Tools.ps1"
click node_diagnostics "https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/diagSettingsMGs/diagSettingsMGs.json"

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_portal,node_armroot,node_samples toneBlue
class node_prereqs,node_mgstructure,node_subscriptionorg,node_network,node_resource_templates toneAmber
class node_policy_defs,node_policy_sets,node_policy_assignments,node_role_assignments,node_custom_roles,node_policy_library toneMint
class node_alz_tools,node_diagnostics,node_subscriptions toneRose
class node_customer toneIndigo
```

## Components

### Deployment options

- [Portal experience](https://github.com/azure/enterprise-scale/tree/main/src/portal): `src/portal`
- [ARM implementation](https://github.com/azure/enterprise-scale/tree/main/eslzArm): `eslzArm`
- [Scenario examples](https://github.com/azure/enterprise-scale/tree/main/examples): `examples`

### Platform foundation

- [Deployment prerequisites](https://github.com/azure/enterprise-scale/blob/main/eslzArm/prerequisites/deployPrerequisites.json): `eslzArm/prerequisites/deployPrerequisites.json`
- [Management groups](https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/mgmtGroupStructure/mgmtGroups.json): `eslzArm/managementGroupTemplates/mgmtGroupStructure/mgmtGroups.json`
- [Subscription organization](https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/subscriptionOrganization/subscriptionOrganization.json): `eslzArm/managementGroupTemplates/subscriptionOrganization/subscriptionOrganization.json`
- [Connectivity templates](https://github.com/azure/enterprise-scale/blob/main/eslzArm/subscriptionTemplates/hubspoke-connectivity.json): `eslzArm/subscriptionTemplates/hubspoke-connectivity.json`
- [Resource templates](https://github.com/azure/enterprise-scale/tree/main/eslzArm/resourceGroupTemplates): `eslzArm/resourceGroupTemplates`

### Governance and security

- [Policy definitions](https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/policyDefinitions/policies.json): `eslzArm/managementGroupTemplates/policyDefinitions/policies.json`
- [Policy initiatives](https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/policyDefinitions/initiatives.json): `eslzArm/managementGroupTemplates/policyDefinitions/initiatives.json`
- [Policy assignments](https://github.com/azure/enterprise-scale/tree/main/eslzArm/managementGroupTemplates/policyAssignments): `eslzArm/managementGroupTemplates/policyAssignments`
- [Role assignments](https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/roleAssignments/roleAssignment.json): `eslzArm/managementGroupTemplates/roleAssignments/roleAssignment.json`
- [Custom roles](https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/roleDefinitions/customRoleDefinitions.json): `eslzArm/managementGroupTemplates/roleDefinitions/customRoleDefinitions.json`
- [Policy library](https://github.com/azure/enterprise-scale/tree/main/src/resources/Microsoft.Authorization/policyDefinitions): `src/resources/Microsoft.Authorization/policyDefinitions`

### Operations

- [ALZ PowerShell tools](https://github.com/azure/enterprise-scale/blob/main/src/Alz.Tools/functions/Alz.Tools.ps1): `src/Alz.Tools/functions/Alz.Tools.ps1`
- [Diagnostics templates](https://github.com/azure/enterprise-scale/blob/main/eslzArm/managementGroupTemplates/diagSettingsMGs/diagSettingsMGs.json): `eslzArm/managementGroupTemplates/diagSettingsMGs/diagSettingsMGs.json`
- **Azure subscriptions**

### Other components

- **Azure adopter**

## Connections

- Azure adopter → Portal experience: deploys through (evidence: `README.md`)
- Azure adopter → ARM implementation: deploys with (evidence: `README.md`)
- Azure adopter → Scenario examples: selects scenario (evidence: `README.md`)
- ARM implementation → Azure subscriptions: provisions landing zones (evidence: `README.md`)
- ARM implementation → Management groups: supports multi-subscription design (evidence: `README.md`)
- ARM implementation → Policy definitions: includes policy IaC (evidence: `README.md`)
- ARM implementation → Connectivity templates: configures platform services (evidence: `README.md`)
- ARM implementation → Deployment prerequisites: includes prerequisites
- ARM implementation → Subscription organization: organizes subscriptions
- ARM implementation → Resource templates: provides resource templates
- Policy definitions → Policy assignments: governs through (evidence: `README.md`)
- Policy definitions → Policy initiatives: supports policy governance
- Policy library → Policy assignments: enables guardrails
- ARM implementation → Role assignments: supports access management (evidence: `README.md`)
- ARM implementation → Custom roles: supports access management
- ARM implementation → Diagnostics templates: supports logging (evidence: `README.md`)
- ALZ PowerShell tools → ARM implementation: supports automation
