Deployment Documentation
Azure deployment guides and operational documentation
🚀 Quick Start (Choose Your Style)
🤖 AI-Native (Recommended)
Have Copilot, Claude, or Cursor? Copy-paste deployment prompts:
→ AI PROMPTS: Deploy with Your AI Assistant ⭐
Just copy a prompt, paste into your AI, and it handles everything. No commands to memorize.
📋 Traditional (Manual)
Prefer command-line control? Step-by-step commands:
Traditional deployment guide with manual commands (25-35 minutes).
📖 Deployment Guides
| Guide | Purpose | When to Use |
|---|---|---|
| Azure Deployment ⭐ | Main deployment guide (25-35 min) | First time deployment |
| GitHub CI/CD Deployment | Automated deployment via workflows | Production, teams, automation |
| Bicep Modules Guide | Bicep modules, AVM usage, script invocation | Infrastructure as code details |
| AI Models Deployment | GPT-4 model configuration | Model scaling and setup |
🏗️ Architecture
High-level system architecture with component diagrams, 4-layer deployment, and deployment flows.
Specialized Architecture Documents:
| Document | Focus Area |
|---|---|
| Network Architecture | VNet design, subnets, NSGs, private endpoints, VPN Gateway, DNS, CIDR strategy |
| Security Architecture | Zero Trust model, managed identities, RBAC, secrets management, compliance |
| Observability | Observability utility, semantic logging, Agent Framework observability, token tracking |
Key Architecture Decisions: - ADR-012: Observability Implementation - How we implement enterprise observability
🤖 AI & Models
| Document | Purpose |
|---|---|
| AI Models Deployment | Deploy AI models via Azure AI Foundry |
| MCP Deployment Config | Model Context Protocol server setup |
🔐 Security & Access
| Document | Purpose |
|---|---|
| RBAC Configuration | Role-based access control setup |
| Bastion Dev Access | Browser-based VNet access with Windows Jump Box (recommended) |
| ~~VPN Dev Access~~ | Deprecated: Replaced by Bastion (ADR-050) |
| Manual Service Principal | Alternative OIDC authentication setup |
📊 Monitoring & Operations
| Document | Purpose |
|---|---|
| Monitoring Setup | Application Insights and Log Analytics configuration |
| Idempotent Deployments | Deployment safety and consistency patterns |
🔧 CI/CD
| Resource | Purpose |
|---|---|
| CI/CD Workflows | GitHub Actions workflow configurations |
📋 Architecture Decisions
Key ADRs related to deployment:
- ADR-041: 4-Layer Deployment Architecture
- ADR-042: Dual Deployment Paths
- ADR-009: Container Apps Deployment
- ADR-039: MCP Servers Deployment
- ADR-021: Azure Verified Modules
- ADR-035: Container Deployment Strategy
🆘 Support
Quick Start: Choose Your Deployment Path → Pick a guide above → Deploy