Häufige Fehler beheben

Pending, ImagePullBackOff, CrashLoopBackOff und unerreichbare Services gezielt eingrenzen.

AnleitungTechnische Referenz · nicht für Cloud-UI erforderlichLesezeit · ca.12 MinutenAktualisiert22. Oktober 2026

Gültigkeit dieser AnleitungEnterprise-Referenz

Für Enterprise Self-Hosted oder eine eigens vereinbarte technische Evaluation. Keine Cloud-Kundenanleitung.

Bevor Sie starten

Sie haben einen bereitgestellten Pilotcluster, eine vertrauenswürdige kubeconfig, kubectl und Zugriff auf einen vereinbarten Namespace. Setzen Sie KUBECONFIG, CP_CONTEXT und CP_NAMESPACE über die Zugangsanleitung, bevor Sie Befehle ausführen. Die Beispiele verwenden eine POSIX-Shell und eine einzelne Zugangsdatei. Gruppierte Blöcke stoppen bei fehlenden Einstellungen, ohne Ihr Terminal zu schließen; sie stellen keine Infrastruktur bereit und vergeben keine Rechte. Mit dem Cluster verbinden →

Nutzen Sie die konkreten Workload- und Containernamen. Die Beispiele betreffen cloud-demo; ersetzen Sie Namen und Selektoren für Ihre Anwendung. Beginnen Sie mit lesenden Prüfungen und sichern Sie Befunde vor Änderungen oder Neustarts.

1. Auswirkung und Ort feststellen

Halten Sie fest, was Nutzer nicht tun können, seit wann der Fehler besteht, welche Änderung vorausging und ob alle Replikate oder nur eines betroffen sind. Bestätigen Sie CP_CONTEXT und CP_NAMESPACE anhand der Übergabe vor der Diagnose.

Beispiel-Workload lesen

(
: "${KUBECONFIG:?Set KUBECONFIG from your handover}"
: "${CP_CONTEXT:?Set CP_CONTEXT from your handover}"
: "${CP_NAMESPACE:?Set CP_NAMESPACE from your handover}"
case "$CP_CONTEXT:$CP_NAMESPACE" in
  YOUR_*|*:YOUR_*) printf '%s\n' 'Replace the YOUR_ context and namespace placeholders first.' >&2; exit 1 ;;
esac
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" get deployment/cloud-demo
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" get pods -l app=cloud-demo
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" describe deployment cloud-demo
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" get events --field-selector type=Warning --sort-by=.metadata.creationTimestamp
)

Wenn bereits der API-Zugang scheitert, nutzen Sie zuerst die Zugangsanleitung. Ein Anwendungsneustart behebt weder abgelaufene Zugänge noch eine unerreichbare Cluster-API.

Mit dem Cluster verbinden →

2. Pod-Befund verfolgen

Einen betroffenen Pod prüfen

(
: "${KUBECONFIG:?Set KUBECONFIG from your handover}"
: "${CP_CONTEXT:?Set CP_CONTEXT from your handover}"
: "${CP_NAMESPACE:?Set CP_NAMESPACE from your handover}"
case "$CP_CONTEXT:$CP_NAMESPACE" in
  YOUR_*|*:YOUR_*) printf '%s\n' 'Replace the YOUR_ context and namespace placeholders first.' >&2; exit 1 ;;
esac
export CP_POD="YOUR_POD_NAME"
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" describe pod "$CP_POD"
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" logs "$CP_POD" -c app --since=15m --tail=100 --limit-bytes=32768
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" logs "$CP_POD" -c app --previous --tail=100 --limit-bytes=32768
)

Signal	Nächste Prüfung	Vermeiden
Pending / FailedScheduling	Events zu Ressourcenmangel, Quote, Taints/Affinity oder Volume-Platzierung; gegebenenfalls PVC-Zustand prüfen.	Weitere Replikate oder Node-Rechte ohne Kapazitätsprüfung.
ImagePullBackOff / ErrImagePull	Image-Schreibweise/Digest, Registry-Erreichbarkeit, Architektur und freigegebene Pull-Zugangsreferenz.	Ausgabe von Registry-Passwörtern oder Wechsel auf ungeprüfte öffentliche Images.
CrashLoopBackOff	Vorherige Logs, Exitcode, notwendige Konfiguration, Schreibpfade und Startup-/Probe-Verhalten.	Sicherheitsregeln/Probes abschalten oder ungeklärte Wiederholungsneustarts.
OOMKilled	Beendigungsgrund, Memory-Limit und gemessene Lastspitzen; Leak oder Unterdimensionierung prüfen.	Alle Speicherlimits als Standardlösung entfernen.
Running, not Ready	Readiness-/Startup-Endpunkt, Port, Konfiguration und Abhängigkeiten; Probe-Fehlerevents prüfen.	Running als Beleg für eine erreichbare Anwendung werten.

Vorherige Logs existieren nur bei verfügbarer früherer Containerinstanz. Fehlende frühere Logs belegen keinen erfolgreichen Lauf. Pod-Beschreibungen können sensible Klartext-Umgebungswerte enthalten; prüfen Sie sie vor Weitergabe lokal.

3. Unerreichbaren Service eingrenzen

Service und Backend-Auswahl lesen

(
: "${KUBECONFIG:?Set KUBECONFIG from your handover}"
: "${CP_CONTEXT:?Set CP_CONTEXT from your handover}"
: "${CP_NAMESPACE:?Set CP_NAMESPACE from your handover}"
case "$CP_CONTEXT:$CP_NAMESPACE" in
  YOUR_*|*:YOUR_*) printf '%s\n' 'Replace the YOUR_ context and namespace placeholders first.' >&2; exit 1 ;;
esac
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" get service/cloud-demo -o wide
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" get pods -l app=cloud-demo --show-labels
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" get endpointslices -l kubernetes.io/service-name=cloud-demo
kubectl --kubeconfig="$KUBECONFIG" --context="$CP_CONTEXT" --namespace="$CP_NAMESPACE" port-forward service/cloud-demo 8080:80 --address=127.0.0.1
)

Prüfen Sie Selektor-Labels, Zielport und Ready-Backends. Testen Sie localhost bei laufendem Port-Forward und beenden Sie mit Strg+C. Ein erfolgreicher lokaler Test grenzt den Fehler ein, belegt aber weder Cluster-DNS noch öffentliches Routing. Vergleichen Sie bei öffentlichen Fehlern Host/Pfad, TLS und DNS mit dem vereinbarten Endpunkt. Bei internen Fehlern lassen Sie Netzwerk/DNS prüfen, wenn Ihre Rolle keine Einsicht erlaubt.

Domains, Ingress & TLS → Persistenten Speicher nutzen →

4. Mit verwertbarem Befund eskalieren

Teilen Sie nur notwendige bereinigte Befunde. Löschen Sie keine Namespaces, PVCs oder Finalizer, um ein Symptom zu beseitigen. Dokumentieren Sie nach Behebung Ursache, Lösung und Vorbeugung und wiederholen Sie den Anwendungsabnahmetest.

Support gezielt anfragen →

Technische Referenzen (Englisch)

Kubernetes beschreibt hier das technische Verhalten. Der für Ihren Cluster bestätigte Funktionsumfang steht in Ihrer Pilotvereinbarung.

Diese Anleitung gilt für Ihren vereinbarten Pilotumfang. Technische Kubernetes-Beispiele sind kein Nachweis einer allgemein verfügbaren Cloud-Funktion.