Fehlerbehebung bei Clustern, die in der GKE On-Prem API registriert sind

Auf dieser Seite erfahren Sie, wie Sie Probleme beim Erstellen eines Google Distributed Cloud-Nutzerclusters in der Google Cloud Console untersuchen.

Die GKE On-Prem API ist eine von Google Cloud gehostete API, mit der Sie den Lebenszyklus Ihrer lokalen Cluster mithilfe von Terraform und Standard Google Cloud tools verwalten können. Die GKE On-Prem API wird in Google Cloud's Infrastruktur ausgeführt. Terraform, die Google Cloud Console und die Google Cloud CLI sind Clients der API. Sie verwenden die API, um Cluster in Ihrem Rechenzentrum zu erstellen, zu aktualisieren, upzugraden und zu löschen. Wenn Sie den Cluster mit einem Standardclient erstellt haben, ist der Cluster in der GKE On-Prem API registriert. Das bedeutet, dass Sie die Standardclients verwenden können, um den Lebenszyklus des Clusters zu verwalten (mit einigen Ausnahmen).

Fehler bei der Clustererstellung

In diesem Abschnitt werden einige Fehler beschrieben, die beim Erstellen von Clustern in der Google Cloud Console auftreten können.

Fehler "Ressource bereits vorhanden"

Die Erstellung eines Nutzerclusters schlägt mit einer Fehlermeldung wie der folgenden fehl:

Resource 'projects/1234567890/[...]/user-cluster1'
already exists
Request ID: 129290123128705826

Diese Fehlermeldung gibt an, dass der Clustername bereits verwendet wird.

Eine Lösung für dieses Problem besteht darin, den Cluster zu löschen und neu zu erstellen:

  1. Erstellen Sie den Cluster noch einmal mit einem anderen Namen, der nicht mit einem vorhandenen Cluster in Konflikt steht.

Fehler durch in Konflikt stehende IP-Adressen

Die Erstellung eines Nutzerclusters schlägt mit einer Fehlermeldung wie der folgenden fehl:

- Validation Category: Network Configuration
- [FAILURE] CIDR, VIP and static IP (availability and overlapping): user: user
  cluster control plane VIP "10.251.133.132" overlaps with
  example-cluster1/control plane VIP "10.251.133.132"

Sie können keine Felder wie VIP der Steuerungsebene und Ingress-VIP im Abschnitt Load-Balancer der Seite Clusterdetails in der Google Cloud Console bearbeiten. So beheben Sie in Konflikt stehende IP-Adressen: Löschen Sie den Cluster und erstellen Sie ihn neu:

  1. Erstellen Sie den Cluster noch einmal mit IP-Adressen, die nicht mit einem vorhandenen Cluster in Konflikt stehen.

Fehlerhafte Cluster entfernen

Ein Cluster kann aus vielen Gründen in einen fehlerhaften Zustand geraten, z. B. aufgrund von:

  • Verbindungsprobleme mit dem Connect-Agent oder der lokalen Umgebung.
  • Der Administratorcluster für einen Nutzercluster wurde gelöscht oder es gibt Verbindungsprobleme zwischen dem Administrator- und dem Nutzercluster.

Wenn sich ein Cluster nicht über die Console löschen lässt, verwenden Sie gcloud CLI-Befehle, um Ressourcen aus fehlerhaften Clustern zu löschen. Google Cloud Wenn Sie die gcloud CLI nicht vor Kurzem aktualisiert haben, führen Sie den folgenden Befehl aus, um die Komponenten zu aktualisieren:

gcloud components update

Löschen Sie als Nächstes die Google Cloud Ressourcen.

Nutzercluster

  1. Löschen Sie den Nutzercluster:

    gcloud container  clusters delete USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --force \
  --allow-missing \
  --ignore-errors

    Ersetzen Sie Folgendes:

    • USER_CLUSTER_NAME: Name des Nutzerclusters, der gelöscht werden soll.

    • PROJECT_ID: Die ID des Projekts, bei dem der Cluster registriert ist.

    • REGION: Der Google Cloud Standort, der mit dem Nutzercluster verknüpft ist. Der Standort wird in der Console angezeigt.

      Mit dem Flag --force wird ein Cluster mit Knotenpools gelöscht. Ohne das Flag --force müssen Sie zuerst die Knotenpools und dann den Cluster löschen.

      Mit dem Flag --allow-missing kann der Befehl fortgesetzt werden, wenn der Cluster nicht gefunden wird.

      Mit dem --ignore-errors Flag werden Google Cloud Ressourcen entfernt, wenn der Administrator- und der Nutzercluster nicht erreichbar sind.

      Mit diesem Befehl wird der Cluster gelöscht, falls er vorhanden ist, und sowohl die GKE On-Prem API- als auch die Flottenmitgliedschaftsressourcen aus dem Projekt entfernt Google Cloud.

  2. Prüfen Sie, ob die GKE On-Prem API-Ressourcen gelöscht wurden:

    gcloud container  clusters list \
  --project=PROJECT_ID \
  --location=-

    Wenn Sie --location=- festlegen, werden alle Cluster in allen Regionen aufgelistet. Wenn Sie den Bereich in der Liste verkleinern möchten, legen Sie --location auf eine bestimmte Region fest.

  3. Prüfen Sie, ob die Ressourcen für die Flottenmitgliedschaft gelöscht wurden:

    gcloud container fleet memberships list \
  --project=PROJECT_ID

Administratorcluster

  1. Wenn Sie den Administratorcluster in der GKE On-Prem API registriert haben, heben Sie die Registrierung auf:

    gcloud container  admin-clusters unenroll ADMIN_CLUSTER_NAME \
 --project=PROJECT_ID \
 --location=REGION \
 --allow-missing

    Ersetzen Sie Folgendes:

    • ADMIN_CLUSTER_NAME: Der Name des Administratorclusters.
    • PROJECT_ID: Die Projekt-ID des Hostprojekts der Flotte.
    • REGION: Die Google Cloud Region.

    Mit dem Flag --allow-missing wird die Registrierung des Clusters aufgehoben, wenn die Flottenmitgliedschaft nicht gefunden wird.

    Mit diesem Befehl werden die GKE On-Prem API-Ressourcen aus dem Projekt entfernt Google Cloud.

  2. Entfernen Sie den Cluster aus der Flotte:

    gcloud container fleet memberships delete ADMIN_CLUSTER_NAME \
 --project=PROJECT_ID \
 --location=global

    Mit diesem Befehl werden die Ressourcen für die Flottenmitgliedschaft aus dem Projekt entfernt Google Cloud.

  3. Prüfen Sie, ob die GKE On-Prem API-Ressourcen gelöscht wurden:

    gcloud container fleet memberships delete ADMIN_CLUSTER_NAME --project=FLEET_HOST_PROJECT_ID

    Wenn Sie --location=- festlegen, werden alle Cluster in allen Regionen aufgelistet. Wenn Sie den Bereich in der Liste verkleinern möchten, legen Sie --location auf eine bestimmte Region fest.

  4. Prüfen Sie, ob die Ressourcen für die Flottenmitgliedschaft gelöscht wurden:

    gcloud container fleet memberships list \
  --project=PROJECT_ID

Nächste Schritte

Wenn Sie zusätzliche Unterstützung benötigen, wenden Sie sich an