Häufige Probleme beheben

Auf dieser Seite erfahren Sie, wie Sie häufige Probleme mit GKE on Azure beheben.

Wenn Sie weitere Unterstützung benötigen, wenden Sie sich an den Cloud Customer Care.

Häufige Fehlermeldungen

In den folgenden Abschnitten werden die Ursachen und Lösungen für einige häufige Fehlermeldungen erläutert.

Server hat keine Ressource

Fehler wie error: the server doesn't have a resource type "services" können auftreten, wenn ein Cluster keine laufenden Knotenpools hat oder das Connect Gateway keine Verbindung zu einem Knotenpool herstellen kann. Zum Prüfen des Status Ihrer Knotenpools führen Sie folgenden Befehl aus:

gcloud container azure node-pools list \
    --cluster-name CLUSTER_NAME \
    --location LOCATION

Dabei gilt:

  • CLUSTER_NAME: der Name des Clusters
  • LOCATION: der Google Cloud Standort, der Ihren Cluster verwaltet

Die Ausgabe enthält die Namen der Knotenpools Ihres Clusters. Erstellen Sie einen Knotenpool, wenn kein Knotenpool aufgeführt ist.

Verbotener Nutzer

Der folgende Fehler tritt auf, wenn Ihr Nutzername keinen Administratorzugriff auf Ihren Cluster hat:

Error from server (Forbidden): users "administrator@example.com" is forbidden:
User "system:serviceaccount:gke-connect:connect-agent-sa" cannot impersonate
resource "users" in API group "" at the cluster scope

Sie können zusätzliche Nutzer konfigurieren, indem Sie beim Erstellen eines Clusters das Flag --admin-users übergeben.

Wenn Sie ein Connect Gateway verwenden und keine Verbindung zu Ihrem Cluster herstellen können, gehen Sie so vor:

  1. Rufen Sie die autorisierten Nutzer für Ihren Cluster ab.

    gcloud container azure clusters describe CLUSTER_NAME \
        --format 'value(authorization.admin_users)'
    

    Ersetzen Sie CLUSTER_NAME durch den Namen Ihres Clusters.

    Die Ausgabe enthält die Nutzernamen mit Administratorzugriff auf den Cluster. Beispiel:

    {'username': 'administrator@example.com'}
    
  2. Rufen Sie den Nutzernamen ab, der derzeit bei der Google Cloud CLI authentifiziert ist.

    gcloud config get-value account
    

    Die Ausgabe enthält das Konto, das mit der Google Cloud CLI authentifiziert wurde. Wenn die Ausgabe von gcloud containers azure clusters describe und gcloud config get-value account nicht übereinstimmt, führen Sie gcloud auth login aus und authentifizieren Sie sich als Nutzername mit Administratorzugriff auf den Cluster.

Probleme mit kubectl-Befehlen

In den folgenden Abschnitten wird beschrieben, wie Sie Probleme mit nicht reagierenden oder fehlgeschlagenen kubectl-Befehlen beheben.

kubectl-Befehle reagieren nicht mehr

Wenn in Ihrem Cluster eine Kubernetes-Version vor 1.25 ausgeführt wird und kubectl-Befehle nicht reagieren oder das Zeitlimit überschreitet, ist dies häufig darauf zurückzuführen, dass Sie noch keinen Knotenpool erstellt haben. Standardmäßig generiert GKE in Azure kubeconfig-Dateien, die ein Connect-Gateway als über das Internet erreichbaren Endpunkt verwenden. Damit dies funktioniert, muss das gke-connect-agent-Deployment in einem Knotenpool im Cluster ausgeführt werden.

Führen Sie folgenden Befehl aus, um weitere Diagnoseinformationen abzurufen:

kubectl cluster-info -v=9

Sind keine laufenden Knotenpools vorhanden, schlagen Anfragen an connectgateway.googleapis.com mit dem 404-cannot find active connections for cluster-Fehler fehl.

Bei Clustern mit der Kubernetes-Version 1.25 oder höher wird gke-connect-agent auf der Steuerungsebene ausgeführt und ein Knotenpool ist nicht erforderlich. Wenn der Befehl kubectl nicht reagiert, prüfen Sie die Logs der Komponenten der Steuerungsebene mit Cloud Logging.

Befehle „kubectl exec“, „kubectl attach“ und „kubectl port-forward“ schlagen fehl

Die Befehle kubectl exec, kubectl attach und kubectl port-forward können bei der Verwendung eines Connect-Gateways mit der Meldung error: unable to upgrade connection fehlschlagen. Dies ist eine Einschränkung, wenn das Connect-Gateway als Kubernetes API-Server-Endpunkt verwendet wird.

Verwenden Sie zur Umgehung dieses Problems eine kubeconfig, die den privaten Endpunkt des Clusters angibt. Eine Anleitung zum Zugriff auf den Cluster über seinen privaten Endpunkt finden Sie unter Clusterzugriff für kubectl konfigurieren.

Generische kubectl-Fehlerbehebung

Wenn Sie das Connect-Gateway verwenden:

  • Prüfen Sie, ob das Connect-Gateway in Ihrem Google Cloud -Projekt aktiviert ist:

    gcloud services enable connectgateway.googleapis.com
    
  • Bei Clustern mit einer Kubernetes-Version vor 1.25 muss mindestens ein Linux-Knotenpool und die gke-connect-agent ausgeführt werden. Weitere Informationen finden Sie unter Fehlerbehebung bei Clusterverbindungen.

  • Prüfen Sie bei Clustern mit der Kubernetes-Version 1.25 oder höher die gke-connect-agent-Logs in Cloud Logging.

Nächste Schritte