-
Notifications
You must be signed in to change notification settings - Fork 515
DeploymentFlow
This document outlines the prerequisites, dependencies and flow to help orchestrate an end-to-end Azure Landing Zone deployment. The orchestration templates provided with this reference implementation have been pre-configured to follow the dependencies described in this document.
- Azure Active Directory Tenant.
- Minimum 1 subscription. Subscription(s) are required when configuring
Log Analytics Workspace
&Hub Networking
services. Each can be deployed in the same subscription or separate subscriptions based on deployment requirements. - Deployment Identity with
Owner
permission to the/
root management group. Owner permission is required to allow the Service Principal Account to create role-based access control assignments. See configuration instructions below.
Modules in this reference implementation must be deployed in the following order to ensure consistency across the environment:
Order | Module | Description | Prerequisites | Module Documentation |
---|---|---|---|---|
1 | Management Groups | Configures the management group hierarchy to support Azure Landing Zone reference implementation. | Owner role assignment at / root management group. |
infra-as-code/bicep/modules/management-groups/README.md |
2 | Custom Role Definitions | Configures custom roles based on Cloud Adoption Framework's recommendations at the organization management group . |
Management Groups. | infra-as-code/bicep/modules/custom-role-definitions/README.md |
3 | Custom Policy Definitions | Configures Custom Policy Definitions at the organization management group . |
Management Groups. | infra-as-code/bicep/modules/policy/definitions/README.md |
4 | Logging & Sentinel | Configures a centrally managed Log Analytics Workspace, Automation Account and Sentinel in the Logging subscription. |
Management Groups & Subscription for Log Analytics and Sentinel. | infra-as-code/bicep/modules/logging/README.md |
5 | Built-In and Custom Policy Assignments | Creates policy assignments to provide governance at scale. | Management Groups & Log Analytics Workspace. | TBD |
6 | Role Assignments | Creates role assignments using built-in and custom role definitions. | Management Groups & Subscriptions. | infra-as-code/bicep/modules/reusable/role-assignments/README.md |
7 | Subscription Placement | Moves one or more subscriptions to the target management group. | Management Groups & Subscriptions. | infra-as-code/bicep/modules/reusable/subscription-placement/subscription-placement.bicep |
8 | Hub Networking | Creates Hub networking infrastructure with Azure Firewall to support Hub & Spoke network topology in the Connectivity subscription. |
Management Groups, Subscription for Hub Networking. | infra-as-code/bicep/modules/hub-networking/README.md |
9 | Corp Connected Spoke Network | Creates Spoke networking infrastructure with Virtual Network Peering to support Hub & Spoke network topology. Spoke subscriptions are used for deploying construction sets and workloads. | Management Groups, Hub Networking & Subscription for spoke networking | infra-as-code/bicep/modules/spoke-networking/README.md |
A service principal account is required to automate through Azure DevOps or GitHub Workflows.
-
Service Principal Name: any name (i.e. spn-azure-platform-ops)
-
RBAC Assignment
-
Scope:
/
(Root Management Group) -
Role Assignment:
Owner
-
See step-by-step instructions on Azure Docs to configure the role assignment at /
root management group.
Configure Service Principal Account in Azure DevOps or GitHub:
-
Azure DevOps: Setup Service Connection
-
GitHub: Connect GitHub Actions to Azure
If you discover any documentation bugs or would like to request new content, please raise them as an issue on the repo.
Contributions to this wiki are done through the main repo under docs/wiki.
- Wiki Home
- Deployment Flow
- Consumer Guide
- How Does ALZ-Bicep Implement Azure Policies?
- How Does ALZ-Bicep Implement resilient deployments across availability zones?
- Contributing
- Telemetry Tracking Using Customer Usage Attribution (PID)
- Azure Container Registry Deployment - Private Bicep Registry
- Sample Pipelines
- Code tours