Skip to content

Scenario Router

Use this page when you have a specific situation and want to jump straight to the page that answers it. This is a breadth-first index across four lifecycle phases — Plan, Deploy, Operate, Troubleshoot — that complements the depth-first Learning Paths and the symptom-first Decision Tree.

Start with Learning Paths if you're new to AKS

This page assumes you already know what you're trying to do. If you're still deciding what to learn first, start with Learning Paths — it sequences a role-based tour of the guide. Use this Scenario Router when you have a specific question and want to jump to the exact page that answers it.

How to Use This Router

  • Pick the table for the lifecycle phase you're in — Plan, Deploy, Operate, or Troubleshoot.
  • Scan the left column for the situation that matches yours; open the destination on the right.
  • If two rows fit, prefer the row from the phase you're actually in — the same platform concept often appears in more than one phase.
  • If your situation spans two phases (a cluster design choice today that will become a scheduling or scaling failure later), check Cross-Phase Scenarios first.
  • Every destination is a real page in this guide, not an external link and not an aspirational page.
  • Rows are intentionally short. Follow the link for the depth; this table is a switchboard, not a summary.
  • If your situation is missing, open an issue — the router is meant to grow.

Lifecycle Overview

flowchart LR
    A[Plan] --> B[Deploy]
    B --> C[Operate]
    C --> D[Troubleshoot]
    D -.-> A

I'm Planning

Situation Where to go
I'm choosing which learning path to follow Learning Paths — role-based reading paths
I'm deciding between AKS, App Service, and Container Apps AKS vs Other Compute — compute selection
I want to understand AKS cluster architecture Cluster Architecture — control plane and worker topology
I'm choosing a CNI model (Azure CNI, kubenet, Overlay) Networking Models — CNI comparison and workload fit
I'm designing node pools (system vs user, spot vs on-demand) Node Pools — pool strategy and SKU sizing
I'm designing identity and secrets (Workload Identity, Key Vault CSI) Identity and Secrets — identity model and secret flow
I'm designing persistent storage (Disk, Files, Blob) Storage Options — storage class comparison
I'm designing the production baseline (security, upgrades, monitoring) Production Baseline — hardening checklist
I want to avoid common AKS anti-patterns Common Anti-Patterns — what to not do and why

I'm Deploying

Situation Where to go
I'm confirming my Azure, tooling, and permissions are ready Prerequisites — Azure, kubectl, and permissions checklist
I'm creating my first AKS cluster Cluster Creation — CLI and IaC flows
I want a hands-on tutorial to deploy AKS end-to-end Tutorial 01: AKS Cluster Deployment — full guided deployment
I'm configuring or adding node pools Node Pool Operations — add, resize, and upgrade pools
I'm designing ingress and load balancing Ingress and Load Balancing — ingress patterns
I want a hands-on tutorial for Application Gateway Ingress Tutorial 02: Application Gateway Ingress — AGIC end-to-end
I want a hands-on tutorial for Azure Key Vault CSI driver Tutorial 03: Azure Key Vault CSI Driver — secret injection

I'm Operating in Production

Situation Where to go
I need day-2 operational procedures Operations Hub — production runbooks
I want to follow production best practices Best Practices Hub — hardening and design guidance
I need to upgrade Kubernetes or node image versions Upgrades — cluster and node pool upgrades
I need to scale a cluster or node pool Scaling Operations — manual and autoscale operations
I need to wire monitoring, logs, and alerts Monitoring and Logging — Container Insights and Log Analytics
I need to configure a maintenance window Maintenance Windows — planned-maintenance configuration
I need to rotate cluster credentials and certificates Credential Rotation — kubeconfig, service principal, and cert rotation
I need to control cost across a portfolio Cost Optimization — spot pools, right-sizing, and scale-to-zero
I need to enforce workload governance (quotas, policy) Resource Governance — namespace quotas and Azure Policy

I'm Troubleshooting

Situation Where to go
I need to systematically diagnose an issue Decision Tree — hypothesis-driven triage flow
I need to know what evidence to collect Evidence Map — question → kubectl + KQL artifact index
I want quick pattern-match cards for common symptoms Quick Diagnosis Cards — one-page symptom cards
I need the failure-boundary architecture of AKS Architecture Overview — control plane, node, and workload boundaries
An incident just started and I have 10 minutes First 10 Minutes Hub — ordered triage checklists
My pods are failing (pending, crashing, evicted) First 10 Minutes: Pod Failures — pod-level triage
I'm losing service or ingress connectivity First 10 Minutes: Connectivity — service and ingress triage
My workload has performance or latency regressions First 10 Minutes: Performance — CPU, memory, and scheduling triage
A pod is stuck in CrashLoopBackOff Pod CrashLoop — restart-loop diagnosis
The cluster autoscaler is not adding or removing nodes Cluster Autoscaler Issues — autoscaler diagnosis

Cross-Phase Scenarios

Some situations straddle two phases — the cluster design choice you make while planning determines the failure mode you eventually debug. These rows link the two together so you can see the pattern and the drill in one place. If you're only in one phase today, still skim this table: it's the cheapest way to preview which decisions will hurt later.

Situation Where to go
I'm designing node pools and want to preview the node-not-ready failure mode Node Pools then Node Not Ready — plan + incident
I'm choosing a CNI model and want to see the IP-exhaustion failure mode Networking Models then CNI IP Exhaustion — plan + drill
I'm designing ingress and want to see the ingress-failure mode Ingress and Load Balancing then Ingress Failure — plan + drill
I'm planning autoscale and want to see the scaling-failure mode Scaling Operations then Scaling Failure — plan + incident

When This Router Isn't the Right Entry Point

  • You're brand new to AKS → start with Learning Paths instead.
  • You already have a symptom (pod crash, node not ready, ingress 502, autoscaler stuck) and don't know which lifecycle phase you're in → jump to Decision Tree or Quick Diagnosis Cards.
  • You're picking between AKS, App Service, and Container Apps for a brand-new workload → use AKS vs Other Compute.

See Also

Sources