Admincluster löschen

Auf dieser Seite wird beschrieben, wie Sie einen Administratorcluster löschen, der mit Google Distributed Cloud (nur Software) für VMware erstellt wurde.

Vorbereitung

Führen Sie vor dem Löschen eines Administratorclusters die folgenden Schritte aus:

  • Löschen Sie die zugehörigen Nutzercluster. Siehe Nutzercluster löschen.
  • Löschen Sie alle Arbeitslasten, die PodDisruptionBudgets (PDBs) vom Administratorcluster verwenden.
  • Löschen Sie alle externen Objekte, z. B. PersistentVolumes, aus dem Administratorcluster.

  • Legen Sie auf Ihrer Administratorworkstation eine Umgebungsvariable KUBECONFIG fest, die auf die kubeconfig des Administratorclusters verweist, den Sie löschen möchten:

    export KUBECONFIG=ADMIN_CLUSTER_KUBECONFIG

    Dabei ist ADMIN_CLUSTER_KUBECONFIG der Pfad der kubeconfig-Datei des Administratorclusters.

  • Optional können Sie den folgenden Befehl auf Ihrer Administrator-Workstation ausführen, um den Namen des Administratorclusters abzurufen:

    kubectl get -n=kube-system onpremadmincluster

Registrierung des Administratorclusters aufheben

Wenn der Administratorcluster in der GKE On-Prem API registriert ist, müssen Sie die Registrierung des Clusters in der API aufheben, bevor Sie andere Clusterressourcen löschen. Wenn Sie die Registrierung des Clusters aufheben, werden die GKE On-Prem API-Ressourcen aus Google Cloudentfernt. Wenn Sie die Registrierung des Clusters nicht aufheben, wird er weiterhin in derGoogle Cloud Console auf der Seite Kubernetes Engine > Cluster angezeigt.

Wenn Sie den Administratorcluster mit der Google Cloud Console oder Terraform erstellt haben, wird der Cluster automatisch in der GKE On-Prem API registriert. Administratorcluster, die mit Version 1.16 oder höher mit dem gkectl-Befehlszeilentool erstellt wurden, werden automatisch in der GKE On-Prem API registriert. Wenn Ihr Administratorcluster mit gkectl mit einer früheren Version erstellt wurde, ist der Cluster in den folgenden Fällen in der API registriert:

  1. Listen Sie alle registrierten Administratorcluster in Ihrem Projekt auf:

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

    Ersetzen Sie PROJECT_ID durch die ID des Flotten-Hostprojekts.

    Der Befehl gibt den Namen jedes Administratorclusters aus, der im GKE On-Prem API im Projekt zusammen mit der Google Cloud Region registriert ist.

    Wenn Sie --location=- festlegen, bedeutet dies, dass alle Cluster in allen Regionen aufgelistet werden. Wenn Sie den Bereich in der Liste verkleinern möchten, legen Sie --location auf die Region fest, die Sie bei der Clusterregistrierung angegeben haben.

  2. Heben Sie die Registrierung des Clusters von der GKE On-Prem API auf:

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

    Ersetzen Sie dabei Folgendes:

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

    Wenn der Befehl fehlschlägt, versuchen Sie, ihn mit dem Flag --ignore-errors noch einmal auszuführen.

Logging und Monitoring löschen

Überspringen Sie diesen Abschnitt, wenn Ihr Cluster Version 1.30 oder höher hat. Da die benutzerdefinierten Ressourcen für Logging und Monitoring nicht auf Clustern mit Version 1.30 und höher bereitgestellt werden, geben die Befehle nichts zurück, wenn Sie sie ausführen.

Die von StatefulSets bereitgestellten Logging- und Monitoring-Pods von Google Distributed Cloud verwenden PDBs, die verhindern können, dass Knoten ordnungsgemäß geleert werden. Um einen Administratorcluster ordnungsgemäß zu löschen, müssen Sie diese Pods löschen.

Führen Sie die folgenden Befehle aus, um Logging- und Monitoring-Pods zu löschen:

kubectl delete monitoring --all -n kube-system
kubectl delete stackdriver --all -n kube-system

Durch das Löschen von Monitoring-Pods werden die mit StatefulSets verknüpften PersistentVolumes (PVs) gelöscht. Das PersistentVolume für Stackdriver muss jedoch separat gelöscht werden.

Das Löschen des Stackdriver-PV ist optional. Wenn Sie das PV nicht löschen möchten, notieren Sie sich den Speicherort und den Namen des zugehörigen PV an einem externen Speicherort außerhalb des Nutzerclusters.

Das Löschen des PV wird durch das Löschen des PVC-Werts (Persistent Volume Claim) ausgelöst.

Führen Sie den folgenden Befehl aus, um den Stackdriver-PVC zu finden:

kubectl get pvc -n kube-system

Führen Sie den folgenden Befehl aus, um den PVC zu löschen:

kubectl delete pvc -n kube-system PVC_NAME

Entfernen von Logging und Monitoring prüfen

Führen Sie die folgenden Befehle aus, um zu prüfen, ob Logging und Monitoring entfernt wurden:

kubectl get pvc -n kube-system
kubectl get statefulsets -n kube-system

Die F5-Partition eines Administratorclusters bereinigen

Überspringen Sie diesen Abschnitt, wenn Sie den F5-Load-Balancer nicht verwenden.

Wenn Sie den Namespace gke-system aus dem Administratorcluster löschen, wird die F5-Partition ordnungsgemäß bereinigt, sodass Sie die Partition für einen anderen Administratorcluster wiederverwenden können.

Führen Sie den folgenden Befehl aus, um den Namespace gke-system zu löschen:

kubectl delete ns gke-system

Löschen Sie dann alle verbleibenden Dienste vom Typ LoadBalancer. Führen Sie den folgenden Befehl aus, um alle Dienste aufzulisten:

kubectl get services --all-namespaces

Löschen Sie jeden Dienst vom Typ LoadBalancer mit dem folgenden Befehl:

kubectl delete service SERVICE_NAME -n SERVICE_NAMESPACE

Gehen Sie dann über die F5 BIG-IP-Konsole so vor:

  1. Wechseln Sie in der oberen rechten Ecke der Konsole zur Partition, die Sie bereinigen möchten.
  2. Wählen Sie Lokaler Traffic > Virtuelle Server > Virtuelle Serverliste aus.
  3. Im Menü Virtual Servers entfernen Sie alle virtuellen IP-Adressen.
  4. Wählen Sie Pools aus und löschen Sie dann alle Pools.
  5. Wählen Sie Knoten aus und löschen Sie dann alle Knoten.

Bereinigung der F5-Partition prüfen

Befehlszeile

Prüfen Sie mit dem folgenden Befehl, dass die VIP nicht erreichbar ist:

ping -c 1 -W 1 F5_LOAD_BALANCER_IP; echo $?

Wenn die VIP ausfällt, wird 1 zurückgegeben.

F5-Benutzeroberfläche

So prüfen Sie, ob die Partition von der F5-Benutzeroberfläche bereinigt wurde:

  1. Klicken Sie rechts oben auf das Drop-down-Menü Partition. Wählen Sie die Partition des Administratorclusters aus.
  2. Wählen Sie im Hauptmenü links Lokaler Traffic > Netzwerkkarte aus. Unter der Netzwerkkarte für lokalen Traffic sollte nichts aufgeführt sein.
  3. Wählen Sie unter Lokaler Traffic > Virtuelle Server die Option Knoten aus und wählen Sie dann Knotenliste aus. Hier sollte auch nichts aufgeführt sein.

Wenn noch Einträge vorhanden sind, löschen Sie diese manuell von der Benutzeroberfläche.

Computer mit Administratorknoten ausschalten

Führen Sie zuerst diesen Befehl aus, um die Namen der Maschinen abzurufen, bevor Sie sie ausschalten.

kubectl get machines -o wide

In der Ausgabe werden die Namen der Maschinen aufgelistet. Sie finden sie jetzt in der vSphere-UI.

Zum Löschen der Knotenmaschinen der Admin-Steuerungsebene müssen Sie alle verbleibenden Admin-VMs im vSphere-Ressourcenpool ausschalten.

vSphere-Benutzeroberfläche

Führen Sie diese Schritte aus:

  1. Wählen Sie im vSphere-Menü die VM aus dem vSphere-Ressourcenpool aus.
  2. Klicken Sie oben im VM-Menü auf Aktionen.
  3. Wählen Sie Power > Ausschalten aus. Es kann einige Minuten dauern, bis die VM ausgeschaltet wird.

Maschinen mit Administratorknoten löschen

Nachdem die VM heruntergefahren wurde, können Sie die VM löschen.

vSphere-Benutzeroberfläche

Führen Sie diese Schritte aus:

  1. Wählen Sie im vSphere-Menü die VM aus dem vSphere-Ressourcenpool aus.
  2. Klicken Sie oben im VM-Menü auf Aktionen.
  3. Klicken Sie auf Vom Laufwerk löschen.

Datenlaufwerk löschen

Nachdem Sie die VMs gelöscht haben, können Sie das Datenlaufwerk löschen. Die Schritte unterscheiden sich geringfügig, je nachdem, ob Sie einen hochverfügbaren (HA) oder nicht hochverfügbaren Administratorcluster haben.

Führen Sie in der vSphere-Benutzeroberfläche die folgenden Schritte aus:

Ohne Hochverfügbarkeit

  1. Wählen Sie im vSphere-Menü das Datenlaufwerk aus dem Datenspeicher aus, wie in der Konfigurationsdatei des Administratorclusters im Feld vCenter.dataDisk angegeben.
  2. Klicken Sie in der Mitte des Datastore-Menüs auf Löschen.

HA

Die Datenlaufwerkpfade für die drei Maschinen der Administrator-Steuerungsebene werden automatisch unter /anthos/ADMIN_CLUSTER/default/ generiert. Beispiel:

/anthos/ADMIN_CLUSTER_NAME/default/MACHINE_NAME-0-data.vmdk
/anthos/ADMIN_CLUSTER_NAME/default/MACHINE_NAME-1-data.vmdk
/anthos/ADMIN_CLUSTER_NAME/default/MACHINE_NAME-2-data.vmdk

Führen Sie die folgenden Schritte aus, um jedes Datenlaufwerk zu löschen:

  1. Wählen Sie im vSphere-Menü das Datenlaufwerk aus dem Datenspeicher aus.
  2. Klicken Sie in der Mitte des Datastore-Menüs auf Löschen.

Datei checkpoint.yaml löschen

Wenn Sie einen hochverfügbaren Administratorcluster löschen, überspringen Sie diesen Schritt, da hochverfügbare Administratorcluster die Prüfpunktdatei nicht unterstützen.

Die Datei DATA_DISK_NAME-checkpoint.yaml, wobei DATA_DISK_NAME der Name des Datenlaufwerks ist, befindet sich im selben Ordner wie das Datenlaufwerk. Löschen Sie diese Datei.

Registrierung des Administratorclusters aufheben

Wenn Sie einen Administratorcluster erstellen, wird er automatisch bei einerGoogle Cloud -Flotte registriert. Sie müssen die Registrierung des Clusters aufheben, nachdem Sie die Administratorknoten-VMs gelöscht haben. Andernfalls wird der Cluster automatisch von einem Controller im Cluster neu registriert.

Wenn Sie die Registrierung des Clusters aufheben, werden die Ressourcen für die Flottenmitgliedschaft ausGoogle Cloudentfernt. Wenn Sie den Cluster nicht abmelden, wird er weiterhin in der Google Cloud Console auf der Seite Kubernetes Engine > Cluster angezeigt.

  1. Führen Sie den folgenden Befehl aus und notieren Sie sich den Speicherort:

    gcloud container fleet memberships list \
    --project=PROJECT_ID

  2. Führen Sie den folgenden Befehl aus, um die Flottenmitgliedschaft zu löschen, wodurch die Registrierung des Clusters aufgehoben wird:

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

    Ersetzen Sie MEMBERSHIP_REGION durch den Speicherort, der vom Befehl gcloud container fleet memberships list ausgegeben wird. Dies kann global oder eine Google Cloud -Region sein.

Wenn Sie fertig sind

Löschen Sie nach dem Löschen des Administratorclusters dessen kubeconfig.