How azure/aks-app-routing-operator works
Main Components
a. Core Operator Components:
• Controller Manager (main control loop)
• Custom Resource Definitions (CRDs)
• Reconciliation Logic
• Resource Watchers
b. External Integration Points:
• Azure Key Vault integration
• DNS management (External DNS)
• NGINX Ingress Controller
• Open Service Mesh (OSM) integration
• Prometheus metrics integration
c. Supporting Components:
• Configuration Management
• Manifest Management
• Resource Reconcilers
┌─ Kubernetes Cluster ──────────────────────────────────────────┐
• ┌─ AKS Web Application Routing Operator ──────────────────┐ │
• ┌─ Controller Manager ─┐ ┌─ Resource Handlers ─┐ │ │
• Main Control Loop │ │ - NGINX Ingress │ │ │
• Metrics Collection │ │ - External DNS │ │ │
• Event Handling │ │ - Key Vault │ │ │
• ┘ │ - OSM │ │ │
• ┘ │ │
• ┌─ Reconcilers ───────┐ ┌─ Manifests ────────┐ │ │
• Ingress │ │ - NGINX Config │ │ │
• Service │ │ - DNS Config │ │ │
• Certificate │ │ - Policy │ │ │
• ┘ └──────────────────────┘ │ │
• ┘ │
• ┌─ Managed Resources ───────────────────────────────────┐ │
• NGINX Ingress Controllers │ │
• DNS Records │ │
• TLS Certificates │ │
• Service Mesh Configuration │ │
• ┘ │
• ┘
┌─ External Azure Services ─────────────────────────────────────┐
• Azure Key Vault │
• Azure DNS │
• Azure Container Registry │
• ┘
Key Relationships to Highlight
• Controller watching Custom Resources
• Reconciliation loops between controllers and managed resources
• Integration points with Azure services
• Traffic flow through NGINX Ingress
• Certificate and secret management flow
• Metrics collection paths
Additional Details
• Version information for supported NGINX versions
• Configuration options for different features
• High availability components
• Optional components (like OSM integration)
Notes for Implementation
• Keep the core operator logic centralized
• Clear separation between operator and managed resources
• Declarative nature of the operator
• Monitoring and observability paths
• Security boundaries and authentication flows