Task 03: Create Resource Groups
DOCUMENT CATEGORY: Runbook
SCOPE: Simplified deployment — single resource group
PURPOSE: Create the resource group that holds all Azure Local cluster resources
MASTER REFERENCE: Microsoft Learn — Resource Groups
Status: Active
Overview
Create the single resource group that will contain all Azure Local cluster resources. In the simplified deployment model, one resource group provides the primary organizational boundary for access control, cost tracking, and lifecycle management.
What This Accomplishes
- Resource container — single resource group for the entire Azure Local cluster
- Access control — resource group-level RBAC boundary
- Cost tracking — scoped cost allocation for the cluster
- Lifecycle management — coordinated resource deployment and cleanup
The single subscription deployment creates a single resource group for all cluster resources. The full deployment model uses multiple resource groups scoped by function. See the full deployment path for details.
Prerequisites
| Prerequisite | Detail |
|---|---|
| Subscription | Created and accessible (Task 02) |
| Permissions | Contributor or Owner role on the subscription |
| Authenticated Azure session | See Authentication |
infrastructure.yml | Configured with subscription ID, resource group name, and region |
Resource Group Reference
| Attribute | Value | Config Path |
|---|---|---|
| Subscription | Per config | infrastructure.yml: azure.subscription_id |
| Resource Group Name | Per config | infrastructure.yml: azure.resource_group |
| Region | Per config | infrastructure.yml: azure.location |
IIC Example Values
| Attribute | IIC Value |
|---|---|
| Subscription | iic-lz-azurelocal-001 |
| Resource Group | rg-c01-azl-eus-01 |
| Region | eastus |
Target Structure
cmp-iic-root ← root MG (Task 01)
└── cmp-landing-zones-iic ← landing zone MG (Task 01)
└── iic-lz-azurelocal-001 ← subscription (Task 02)
└── rg-c01-azl-eus-01 ← resource group (this task)
├── Azure Local cluster resources
├── Arc-enabled servers
├── Key Vault
└── Storage accounts
Values from infrastructure.yml
The values for this task come from infrastructure.yml (schema 5). Every key, with its type, default and example, is in the variables reference.
Execution Options
- Azure Portal
- Orchestrated Script
- Azure CLI
Azure Portal
When to use: Single deployment, prefer visual interface
Procedure
- Navigate to Resource Groups:
- In Azure Portal, search for Resource groups
- Click + Create
- Configure the resource group:
| Field | Value | Source |
|---|---|---|
| Subscription | <subscription> | infrastructure.yml: azure.subscription_id |
| Resource group | <rg-name> | infrastructure.yml: azure.resource_group |
| Region | <region> | infrastructure.yml: azure.location |
- Complete creation:
- Click Review + create → verify all fields → Create
Validation
- Resource group appears in the correct subscription
- Resource group name matches
infrastructure.yml - Region matches
azure.location
Links
PowerShell
No script of its own. The toolkit has no script folder for the single subscription route. Use the script of the full deployment:
scripts/deploy/02-azure-foundation/phase-01-landing-zones/full-deployment/task-03-create-resource-groups/powershell/Deploy-ResourceGroups.ps1readslanding_zone.resource_groups[](name, subscription, location, purpose), and a file with one entry gives the same result.
./Deploy-ResourceGroups.ps1 -InfrastructureFile ./infrastructure.yml -WhatIf
Requires: modules Az.Resources.
Azure CLI
No script of its own. The toolkit has no script folder for the single subscription route. Use the Azure CLI script of the full deployment:
scripts/deploy/02-azure-foundation/phase-01-landing-zones/full-deployment/task-03-create-resource-groups/azurecli/Deploy-ResourceGroups.azcli.ps1readslanding_zone.resource_groups[](name, subscription, location, purpose), and a file with one entry gives the same result. Or follow the steps in the other tab of this page.
./Deploy-ResourceGroups.azcli.ps1 -InfrastructureFile ./infrastructure.yml -WhatIf
./Deploy-ResourceGroups.azcli.ps1 -InfrastructureFile ./infrastructure.yml
Requires: PowerShell 7 and the Azure CLI, signed in with az login --tenant <azure.tenant_id>.
Troubleshooting
| Symptom | Error | Resolution |
|---|---|---|
| Permission denied | AuthorizationFailed | Verify Contributor or Owner role on the subscription |
| Duplicate name | ResourceGroupAlreadyExists | RG already exists — verify it's in the correct subscription and region, then move on |
| Invalid location | LocationNotAllowed | Check Azure Policy allowed-locations constraints; confirm azure.location in infrastructure.yml |
| Subscription not found | SubscriptionNotFound | Verify azure.subscription_id in infrastructure.yml is correct |
Next Steps
The single subscription landing zone deployment is complete. All three foundational resources are in place:
- Root management group → landing zone management group → subscription → resource group
Proceed to the next phase of the Azure Foundation deployment.
References
Alternatives
The procedures in this task use the methods shown in the tabs above. The toolkit is PowerShell 7 only and has no Bash scripts. A few tasks that act on Azure also have an Azure CLI script written in PowerShell. The script status page of the toolkit lists which task has which script.
Navigation
| Previous | Up | Next |
|---|---|---|
| Task 02 — Create Subscription | Single Subscription Deployment Overview | Phase 02 — Resource Providers |
Version Control
- Created: 2026-01-15 by Hybrid Cloud Solutions
- Last Updated: 2026-03-19 by Hybrid Cloud Solutions
- Version: 3.0.0
Version Control
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0.0 | 2025-03-25 | Azure Local Cloud | Initial release |