Fehlerbehebung für GKE

In diesem Dokument finden Sie eine Liste mit Dokumenten zur Fehlerbehebung für häufige Probleme, die bei der Verwendung von Google Kubernetes Engine (GKE) auftreten können. Die hier aufgeführten Dokumente können Ihnen helfen, Fehler bei Arbeitslasten wie ImagePullBackOff und CrashLoopBackOff zu diagnostizieren, das Verhalten beim Cluster-Autoscaling zu debuggen, Probleme mit PersistentVolumes zu beheben oder Probleme bei der Knotenregistrierung zu beheben.

Wenn Sie noch nicht mit der Fehlerbehebung in GKE vertraut sind, lesen Sie zuerst Einführung in die Fehlerbehebung.

Informationen zum Diagnostizieren und Beheben von Problemen finden Sie in den Dokumenten in den folgenden Abschnitten:

Informationen zur Fehlerbehebung bei GKE-Netzwerken finden Sie in der GKE-Netzwerkdokumentation unter Fehlerbehebung bei GKE-Netzwerken.

Dieses Dokument richtet sich an Administratoren und Architekten, Sicherheitsexperten, Netzwerkspezialisten oder Speicherspezialisten, die Fehler in GKE-Konfigurationen beheben. Weitere Informationen zu GKE-Rollen finden Sie unter Häufig verwendete GKE-Nutzerrollen und -Aufgaben.

Einführung in die Fehlerbehebung

Thema Beschreibung
Einführung in die Fehlerbehebung für GKE Machen Sie sich mit dem allgemeinen Prozess und den grundlegenden Konzepten vertraut, um mit der Fehlerbehebung in GKE zu beginnen.
Service Health und Vorfälle ansehen Hier erfahren Sie, wie Sie den Zustand von GKE und zugehörigen Google Cloud Diensten prüfen, um Plattformprobleme auszuschließen.
Cluster- und Arbeitslastzustand in der Google Cloud Console bewerten Hier erfahren Sie, wie Sie mit der Google Cloud Console GKE-Probleme untersuchen und beheben.
Clusterstatus mit kubectl untersuchen Hier finden Sie häufige kubectl-Befehle und -Techniken zum Diagnostizieren von Problemen in Ihren Clustern und Arbeitslasten.
Verlaufsanalyse mit Cloud Logging durchführen Sie erfahren, wie Sie Cloud Logging effektiv nutzen, um die Ursachen von Problemen in GKE zu finden.
Proaktives Monitoring mit Cloud Monitoring durchführen Cloud Monitoring-Dashboards und -Messwerte verwenden, um GKE-Probleme zu identifizieren, zu diagnostizieren und zu beheben.
Diagnose mit Gemini Cloud Assist beschleunigen Hier erfahren Sie, wie Gemini Sie bei der Diagnose und Behebung von GKE-Problemen unterstützen kann.
Zusammenfassung: Beispiel für ein Fehlerbehebungsszenario Folgen Sie einem Schritt-für-Schritt-Beispiel zur Fehlerbehebung bei einem häufigen Szenario in GKE.

Clustereinrichtung

Thema Beschreibung
Clustererstellung Probleme beim Erstellen von Clustern beheben.
Autopilot-Cluster GKE Autopilot-Cluster diagnostizieren und Fehler beheben, einschließlich Problemen beim Erstellen von Clustern, beim Löschen von Namespaces, bei der Skalierung und bei Arbeitslasten.
kubectl-Befehlszeilentool Fehlerbehebung für das kubectl-Befehlszeilentool in GKE, einschließlich Problemen mit Authentifizierung und Autorisierung. Auf dieser Seite finden Sie auch Informationen zur Fehlerbehebung beim Konnectivity-Proxy, um zu prüfen, ob er dafür verantwortlich ist, dass die Befehle kubectl logs, attach, exec oder port-forward nicht mehr reagieren.
Standardknotenpools Fehlerbehebung bei GKE Standard-Knotenpools, einschließlich Problemen bei der Erstellung von Knotenpools, der Best-Effort-Bereitstellung, beschädigten Instanzmetadaten und der Migration von Arbeitslasten zu neuen Knotenpools.
Status von Knoten NotReady Hier erfahren Sie, wie Sie den Knotenstatus NotReady in GKE diagnostizieren und beheben, indem Sie häufige Ursachen wie Ressourcenmangel, Netzwerkprobleme und Komponentenausfälle beheben.
Knotenregistrierung Hier erfahren Sie, wie Sie Probleme beheben, die beim Hinzufügen von Knoten zu Ihrem GKE Standard-Cluster auftreten können, z. B. Fehler bei der Knotenregistrierung und fehlende Voraussetzungen für die erfolgreiche Knotenregistrierung.
Containerlaufzeit Fehlerbehebung bei Containerlaufzeiten in GKE, einschließlich Problemen mit containerd und dockershim sowie privaten Registries.
Windows Server-Knotenpools Beheben Sie Probleme mit Windows Server-Knotenpools in GKE, einschließlich Fehler beim Pod-Start, Fehler beim Image-Pull, Probleme mit der Netzwerkverbindung und Probleme mit dem Knotenstatus.

Autoscaling

Thema Beschreibung
Cluster Autoscaler skaliert nicht herunter Häufige Gründe dafür, dass in Ihrem Cluster nicht genutzte Knoten nicht entfernt werden, diagnostizieren und beheben Hier erfahren Sie, wie Sie nach Problemen wie restriktiven PodDisruptionBudgets, Pods mit lokalem Speicher oder bestimmten Anmerkungen (z. B. "cluster-autoscaler.kubernetes.io/safe-to-evict": "false") suchen, die das Entfernen von Knoten verhindern.
Cluster Autoscaler skaliert nicht hoch Hier erfahren Sie, warum der Cluster Autoscaler keine neuen Knoten hinzufügt, um die Nachfrage zu decken. Prüfen Sie, ob es nicht planbare Pods gibt, ob Sie die Größenlimits für Cluster oder Knotenpools erreicht haben, und ermitteln Sie potenzielle Probleme mit Ressourcenkontingenten oder der regionalen VM-Verfügbarkeit.
Horizontales Pod-Autoscaling Beheben Sie Probleme, wenn der horizontale Pod-Autoscaler die Pod-Replikate Ihrer Anwendung nicht skaliert. Häufige Probleme beheben, z. B. falsch konfigurierte HorizontalPodAutoscaler-Ressourcen oder Probleme mit der Messwertpipeline.
Vertikales Pod-Autoscaling Probleme mit dem VerticalPodAutoscaler beheben, wenn die Pod-Ressourcen Ihrer Anwendung nicht skaliert werden. Häufige Probleme beheben, z. B. falsch konfigurierte VerticalPodAutoscaler-Ressourcen oder Probleme mit der Messwertpipeline.

Speicher

Thema Beschreibung
Speicher Fehlerbehebung bei Speicherproblemen, einschließlich Problemen mit regionalen nichtflüchtigen Speichern, Laufwerksleistung und Volume-Erweiterung.

Clustersicherheit

Thema Beschreibung
Authentifizierung Beheben Sie Authentifizierungsprobleme in GKE, einschließlich Problemen mit RBAC, Workload Identity Federation for GKE und dem GKE-Metadatenserver.
Dienstkonten Fehlerbehebung bei Dienstkonten, einschließlich des Wiederherstellens des Standarddienstkontos und des Aktivierens des Compute Engine-Standarddienstkontos.
Secrets auf Anwendungsebene Beheben Sie Probleme, die beim Konfigurieren der Verschlüsselung von Secrets auf Anwendungsebene auftreten können, einschließlich fehlgeschlagener Updates und Fehler, bei denen Sie keinen Cloud KMS-Schlüssel verwenden können oder bei denen die Cloud KMS-Schlüsselversion gelöscht wurde.

Stammzertifizierungsstelle des Clusters läuft bald ab

Thema Beschreibung
Root-Zertifizierungsstelle (CA) läuft ab Wenn die Root-Zertifizierungsstelle (CA) Ihres Clusters bald abläuft, erfahren Sie hier, wie Sie eine Rotation von Anmeldedaten durchführen, um Unterbrechungen normaler Clustervorgänge zu vermeiden.

Arbeitslasten

Thema Beschreibung
Bereitgestellte Arbeitslasten Fehlerbehebung für Arbeitslasten, die in einem GKE-Cluster ausgeführt werden, einschließlich PodUnschedulable. Im Abschnitt „PodUnschedulable“ finden Sie Informationen zu Fehlern wie MatchNodeSelector und Does not have minimum availability.
Image-Pulls Fehlerbehebung bei Image-Abrufen. Hier erfahren Sie, was die Ursachen für Status wie ImagePullBackOff und ErrImagePull sind und wie Sie diese Status beheben können, indem Sie häufige Probleme wie Authentifizierung und Netzwerkverbindung beheben.
CrashLoopBackOff-Ereignisse Fehlerbehebung bei CrashLoopBackOff-Ereignissen in GKE. Diagnostizieren Sie Probleme wie Ressourcenerschöpfung, Fehlkonfigurationen von Anwendungen und Fehler bei Aktivitätsprüfungen.
OOM-Ereignisse Fehlerbehebung bei Kubernetes-Ereignissen aufgrund von unzureichendem Arbeitsspeicher (Out of Memory, OOM). Ursachen identifizieren, Ereignistypen unterscheiden und effektive Lösungen für OOM-Kills auf Container- und Knotenebene anwenden.
Arm-Arbeitslasten Beheben Sie Probleme mit Arm-Arbeitslasten, einschließlich abstürzender Pods auf Arm-Knoten.
TPUs Fehlerbehebung bei TPUs, einschließlich Problemen mit Kontingenten, automatischer Knotenbereitstellung, Arbeitslastkonfiguration und Planung.
GPUs Fehlerbehebung bei GPUs, einschließlich Problemen mit der Installation von GPU-Treibern, Geräte-Plug-in-Fehlern und Container-Images.

Clusterverwaltung

Thema Beschreibung
Cluster upgrades Fehlerbehebung und Behebung von Problemen mit GKE-Cluster- und Knotenupgrades, einschließlich langer oder unvollständiger Upgrades, unerwarteter automatischer Upgrades, Fehler und Probleme nach dem Upgrade.
Webhooks Hier erfahren Sie, wie Sie Fehler beheben und für die Stabilität der Steuerungsebene Ihres Clusters sorgen, wenn Sie Zulassungs-Webhooks verwenden.
Namespace bleibt im Status Terminating hängen Beheben Sie Probleme mit Namespaces, die im Status Terminating festhängen, indem Sie die fehlerhaften Komponenten, die das Löschen blockieren, identifizieren und entfernen.
Gleichzeitige Vorgänge Hier erfahren Sie, wie Sie Fehler bei gleichzeitig ausgeführten Vorgängen erkennen und beheben können, indem Sie warten, bis die Vorgänge abgeschlossen sind.

Monitoring

Thema Beschreibung
Systemmesswerte Fehlerbehebung, wenn Systemmesswerte nicht in Cloud Monitoring angezeigt werden.
Monitoring-Dashboards Fehlerbehebung bei Monitoring-Dashboards, einschließlich Problemen beim Aktivieren des Monitorings, fehlenden Kubernetes-Ressourcen und Berechtigungen.
Fehlerbehebung bei fehlenden Logs Fehlerbehebung bei fehlenden GKE-Logs. Hier erfahren Sie, wie Sie den API-Status, die Clustereinstellungen, Berechtigungen, Kontingente, Filter und das Anwendungsverhalten prüfen.

4xx-Fehler

Thema Beschreibung
4xx-Fehler Beheben Sie einige der 400-, 401-, 403- und 404-Fehler, die bei der Verwendung von GKE auftreten können. Diese Seite enthält auch Informationen zur Problembehebung bei Fehlern aufgrund fehlender Bearbeitungsberechtigungen für das Konto.

Bekannte Probleme

Thema Beschreibung
Bekannte Probleme Bekannte Probleme, die sich auf die Verwendung von GKE auswirken können, erkennen und beheben

Nächste Schritte