Skip to main content

Task 03: Create Resource Groups

Runbook Azure

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
Single Subscription vs Full Deployment

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​

PrerequisiteDetail
SubscriptionCreated and accessible (Task 02)
PermissionsContributor or Owner role on the subscription
Authenticated Azure sessionSee Authentication
infrastructure.ymlConfigured with subscription ID, resource group name, and region

Resource Group Reference​

AttributeValueConfig Path
SubscriptionPer configinfrastructure.yml: azure.subscription_id
Resource Group NamePer configinfrastructure.yml: azure.resource_group
RegionPer configinfrastructure.yml: azure.location

IIC Example Values​

AttributeIIC Value
Subscriptioniic-lz-azurelocal-001
Resource Grouprg-c01-azl-eus-01
Regioneastus

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​

When to use: Single deployment, prefer visual interface

Procedure​

  1. Navigate to Resource Groups:
  • In Azure Portal, search for Resource groups
  • Click + Create
  1. Configure the resource group:
FieldValueSource
Subscription<subscription>infrastructure.yml: azure.subscription_id
Resource group<rg-name>infrastructure.yml: azure.resource_group
Region<region>infrastructure.yml: azure.location
  1. 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

Troubleshooting​

SymptomErrorResolution
Permission deniedAuthorizationFailedVerify Contributor or Owner role on the subscription
Duplicate nameResourceGroupAlreadyExistsRG already exists — verify it's in the correct subscription and region, then move on
Invalid locationLocationNotAllowedCheck Azure Policy allowed-locations constraints; confirm azure.location in infrastructure.yml
Subscription not foundSubscriptionNotFoundVerify 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.

PreviousUpNext
Task 02 — Create SubscriptionSingle Subscription Deployment OverviewPhase 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​

VersionDateAuthorChanges
1.0.02025-03-25Azure Local CloudInitial release