Skip to main content

Deployment Guide

End-to-end deployment of Azure infrastructure and Kubernetes services for the robotics reference architecture. This guide covers prerequisites, Terraform provisioning, VPN access, cluster configuration, and teardown.

📖 Deployment Guides​

GuideDescription
PrerequisitesAzure subscription initialization and resource provider registration
Infrastructure DeploymentTerraform configuration for AKS, Azure ML, storage, and backend services
Infrastructure ReferenceArchitecture, module structure, outputs, and troubleshooting
VPN GatewayPoint-to-site and site-to-site VPN for private cluster access
Private DNSDNS zone setup for OSMO UI access
Cluster AutomationScheduled start/stop automation for cost management
Cluster SetupKubernetes service deployment and OSMO configuration
Cluster OperationsAccessing OSMO, troubleshooting, and optional scripts
Cleanup and DestroyRemove cluster components and destroy Azure infrastructure

📋 Deployment Order​

  1. Prerequisites — Azure CLI login, subscription setup (2 min)
  2. Infrastructure — Terraform: AKS, ML workspace, storage (30-40 min)
  3. VPN Gateway — VPN Gateway for private cluster access (20-30 min)
  4. Cluster Setup — GPU Operator, OSMO, AzureML extension (30 min)

[!IMPORTANT] The default configuration deploys a private AKS cluster. The cluster API endpoint is not publicly accessible. You must deploy the VPN Gateway (step 3) and connect before running cluster setup scripts (step 4).

Skip step 3 if you set should_enable_private_aks_cluster = false in your Terraform configuration. See Infrastructure Reference for network configuration options.

📖 Quick Reference​

TaskGuide
Deploy Azure resourcesInfrastructure Deployment
Configure VPN accessVPN Gateway
Set up cluster servicesCluster Setup
Access OSMO UICluster Operations
Remove componentsCleanup and Destroy
Destroy infrastructureCleanup and Destroy

📖 Terminology​

TermDefinition
DeployProvision Azure infrastructure or install cluster components using Terraform or deployment scripts.
SetupPost-deploy configuration and access steps for the cluster and workloads.
CleanupRemove cluster components while keeping Azure infrastructure intact.
DestroyDelete Azure infrastructure (Terraform destroy or resource group deletion).

📚 Related Documentation​

🤖 Crafted with precision by ✨Copilot following brilliant human instruction, then carefully refined by our team of discerning human reviewers.