Skip to main content
Version: 2604 (Preview)

Azure Local Implementation Guide

Runbook Azure

DOCUMENT CATEGORY: Runbook
SCOPE: Complete Azure Local deployment lifecycle
PURPOSE: End-to-end infrastructure deployment guide
MASTER REFERENCE: Microsoft Learn — Azure Local

Status: Active

Two-Repo Architecture

This documentation works alongside the Azure Local Toolkit repository. Clone the toolkit, configure variables.yml, and follow the procedures in this guide.

Getting Started​

  1. Read the introduction docs (Purpose & Scope, How to Use This Runbook)
  2. Clone the Azure Local Toolkit repository
  3. Configure variables.yml with your environment values
  4. Authenticate to Azure — see Authentication
  5. Execute each phase in sequence following this guide

Variable-Driven Configuration​

All deployments are driven by the variables.yml configuration file. Scripts read values from this file — you configure once, then execute.

IIC Example​

All examples in this guide use Infinite azurelocal Corp (IIC). Replace with values from your own variables.yml.

variables.yml (excerpt)
azure:
tenant_id: "00000000-0000-0000-0000-000000000000"
region: "eastus"
management_groups:
tenant_root:
name: "cmp-iic-root"
landing_zone:
name: "cmp-landing-zones-iic"
subscriptions:
lab:
id: "00000000-0000-0000-0000-000000000000"
name: "iic-lz-azurelocal-001"

azure_resources:
resource_group_name: "rg-c01-azl-eus-01"

cluster:
location: "eastus"

Implementation Phases​

The implementation is organized into sequential phases. Complete each phase before moving to the next.

Introduction & Prerequisites​

DocDescription
01 — Purpose & ScopeWhat this runbook covers and deployment boundaries
02 — How to Use This RunbookNavigation, conventions, and document structure
03 — Key Inputs & VariablesConfiguration file structure and required values
04 — Prerequisites & AssumptionsHardware, software, and access prerequisites
05 — AuthenticationAzure session setup and authentication methods

Deployment Phases​

PhaseDescription
01 — CI/CD InfrastructurePipeline and automation infrastructure
02 — Azure FoundationLanding zones, resource providers, RBAC, identity, and management infrastructure
03 — On-Premises ReadinessPhysical hardware, networking, and OS preparation
04 — Cluster DeploymentAzure Local cluster creation and configuration
05 — Operational FoundationsMonitoring, backup, update management
06 — Cluster Testing & ValidationEnd-to-end validation and acceptance testing

Azure Foundation Detail (Phase 02)​

Phase 02 is the largest phase. It contains multiple sub-phases:

Sub-PhaseDescription
Phase 01 — Landing ZonesManagement groups, subscriptions, resource groups
Phase 02 — Resource ProvidersRegister required Azure resource providers
Phase 03 — RBAC & PermissionsRole assignments and access control
Phase 04 — Azure Management InfrastructureLog Analytics, Key Vault, storage
Phase 05 — Identity & SecurityEntra ID integration and security configuration

References​


PreviousUpNext
—Azure LocalPurpose and Scope

Version Control

  • Created: 2026-01-15 by Azure Local Cloud
  • Last Updated: 2026-03-02 by Azure Local Cloud
  • Version: 2.0.0
  • Tags: azure-local, implementation, deployment
  • Keywords: implementation guide, deployment lifecycle, Azure Local
  • Author: Azure Local Cloud