AKS Tutorial für Einsteiger: Azure Kubernetes Guide (2026)

# macOS
brew install azure-cli

# Linux (Debian/Ubuntu)
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

# Windows
winget install Microsoft.AzureCLI

# Anmelden
az login

# Pruefen, ob das richtige Abonnement aktiv ist
az account show --query "{name:name, id:id}" -o table

# Ueber die Azure CLI (funktioniert auf allen Plattformen)
az aks install-cli

# Version pruefen
kubectl version --client

# Resource Group in West Europe (Niederlande) -- guenstig fuer Tutorials
# Fuer Produktion: germanywestcentral oder westeurope
az group create \
  --name aks-tutorial-rg \
  --location westeurope

# AKS-Cluster erstellen
az aks create \
  --resource-group aks-tutorial-rg \
  --name mein-erster-cluster \
  --node-count 2 \
  --node-vm-size Standard_B2s \
  --generate-ssh-keys \
  --network-plugin kubenet

# Dauer: ca. 6-8 Minuten

# kubeconfig herunterladen
az aks get-credentials \
  --resource-group aks-tutorial-rg \
  --name mein-erster-cluster

# Verbindung testen
kubectl get nodes

NAME                                STATUS   ROLES    AGE   VERSION
aks-nodepool1-12345678-vmss000000   Ready    <none>   3m    v1.31.2
aks-nodepool1-12345678-vmss000001   Ready    <none>   3m    v1.31.2

# app.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: hello-aks
spec:
  replicas: 2
  selector:
    matchLabels:
      app: hello-aks
  template:
    metadata:
      labels:
        app: hello-aks
    spec:
      containers:
        - name: nginx
          image: nginx:1.27-alpine
          ports:
            - containerPort: 80
          resources:
            requests:
              cpu: 50m
              memory: 64Mi
            limits:
              cpu: 200m
              memory: 128Mi
          readinessProbe:
            httpGet:
              path: /
              port: 80
            initialDelaySeconds: 5
            periodSeconds: 5
---
apiVersion: v1
kind: Service
metadata:
  name: hello-aks-service
spec:
  type: LoadBalancer
  selector:
    app: hello-aks
  ports:
    - port: 80
      targetPort: 80

# Deployment erstellen
kubectl apply -f app.yaml

# Pod-Status beobachten
kubectl get pods -w

# Warten, bis beide Pods "Running" und "Ready" (1/1) sind
# Dann Ctrl+C druecken

# Service pruefen -- EXTERNAL-IP braucht 1-2 Minuten
kubectl get service hello-aks-service -w

# Externe IP abfragen
kubectl get service hello-aks-service -o jsonpath='{.status.loadBalancer.ingress[0].ip}'

# Auf 5 Replicas hochskalieren
kubectl scale deployment hello-aks --replicas=5

# Status pruefen
kubectl get pods -o wide

# Der Load Balancer verteilt automatisch auf alle Pods

# hpa.yaml
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: hello-aks-hpa
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: hello-aks
  minReplicas: 2
  maxReplicas: 8
  metrics:
    - type: Resource
      resource:
        name: cpu
        target:
          type: Utilization
          averageUtilization: 70

kubectl apply -f hpa.yaml
kubectl get hpa

# Container Insights aktivieren (falls nicht bei der Cluster-Erstellung geschehen)
az aks enable-addons \
  --addons monitoring \
  --resource-group aks-tutorial-rg \
  --name mein-erster-cluster

# CPU/Memory-Verbrauch der Pods
kubectl top pods

# CPU/Memory-Verbrauch der Nodes
kubectl top nodes

# Events im Cluster (hilfreich bei Problemen)
kubectl get events --sort-by='.lastTimestamp' | tail -20

# Detaillierte Pod-Informationen
kubectl describe pod <pod-name>

# Logs eines Pods anzeigen
kubectl logs <pod-name>

# Logs live verfolgen
kubectl logs -f <pod-name>

kubectl describe pod <pod-name>
# Haeufigste Ursache: Nicht genug Ressourcen auf den Nodes
# Loesung: Node-Pool skalieren oder Resource Requests reduzieren

az aks nodepool scale \
  --resource-group aks-tutorial-rg \
  --cluster-name mein-erster-cluster \
  --name nodepool1 \
  --node-count 3

kubectl describe pod <pod-name>
# Image-Name pruefen -- Tippfehler sind die haeufigste Ursache
# Bei privaten Registries: imagePullSecret konfigurieren

# Logs des abgestuerzten Containers pruefen
kubectl logs <pod-name> --previous

# Haeufige Ursachen:
# - Anwendung startet nicht (fehlende Env-Vars, Config)
# - Liveness Probe zu aggressiv (initialDelaySeconds erhoehen)
# - Out of Memory (Memory-Limit erhoehen)

kubectl describe service <service-name>
# Events pruefen -- oft fehlen Berechtigungen fuer den Load Balancer
# Oder: Limit fuer oeffentliche IPs im Abonnement erreicht

# Credentials neu laden
az aks get-credentials \
  --resource-group aks-tutorial-rg \
  --name mein-erster-cluster \
  --overwrite-existing

# Cluster-Status pruefen
az aks show \
  --resource-group aks-tutorial-rg \
  --name mein-erster-cluster \
  --query "powerState" -o table

# Cluster stoppen (spart die Node-Kosten)
az aks stop \
  --resource-group aks-tutorial-rg \
  --name mein-erster-cluster

# Cluster wieder starten
az aks start \
  --resource-group aks-tutorial-rg \
  --name mein-erster-cluster

# Gesamte Resource Group loeschen (Cluster + alle Ressourcen)
az group delete --name aks-tutorial-rg --yes --no-wait