Add-on für Cloud Run for Anthos GKE deinstallieren

Deinstallieren Sie das „GKE-Add-on“ Cloud Run for Anthos aus Ihrem Cluster, einschließlich der zugehörigen Ressourcen und Labels.

In dieser Aufgabe wird mit dem Migrationsskript nur das GKE-Add-on aus dem Cluster entfernt. Alle vorhandenen Cloud Run-Befehle für Anthos-Ressourcen verbleiben in Ihrem Cluster und leiten weiterhin Traffic weiter.

Hinweise

• Sie müssen zuerst prüfen, ob die Anforderungen für das Upgrade erfüllt sind.

• In den Befehlen auf dieser Seite werden die Umgebungsvariablen und das Migrationsskript aus dem Vorbereitungsschritt für das Upgrade verwendet.

• Es ist wichtig, dass Sie jeden Schritt dieses Prozesses in der angegebenen Reihenfolge ausführen.

Überblick

Das Deinstallieren des GKE-Add-ons umfasst:

1. Prüfen, ob der Knotenpool die Anforderungen für ein Upgrade erfüllt.
2. Migrationslabels anwenden und den Zulassungs-Webhook ValidatingWebhookConfiguration erstellen, um zu verhindern, dass Ihre Cloud Run for Anthos-Ressourcen in den folgenden Namespaces gelöscht werden:
   • knative-serving
   • cloud-run-system
   • gke-system

3. Deinstallieren Sie das „GKE Add-on“. Entfernen Sie auch die zugehörigen Managerlabels aus Ihren Cloud Run for Anthos-Ressourcen.

   Beachten Sie, dass dieser Vorgang länger als zehn Minuten ausgeführt werden kann.

4. appdevexperience-operator-Annotationen hinzufügen.

5. Die veraltete Ressource cloudrun.operator.run.cloud.google.com wird entfernt, die nicht für Flotten verwendet wird.

Hinweis: Während der Traffic zu Ihren Diensten unverändert bleibt, gilt die GKE-Steuerungsebene („Master“) Knoten aktualisiert wird, ist daher während des Prozesses vorübergehend nicht verfügbar. Vorgänge, die Zugriff auf die GKE-Steuerungsebene benötigen, z. B. Kubernetes-Ressourcenvorgänge wie Löschen, Aktualisieren oder Erstellen, werden erst nach Abschluss der Aktualisierung durchgeführt.

Add-on für Cloud Run for Anthos GKE deinstallieren

In diesem Abschnitt wird das Migrationsskript verwendet, um das „GKE-Add-on“ zu deinstallieren.

1. Starten Sie das Migrationsskript mit dem folgenden Befehl:

   ./migration-addon.sh --command uninstall-cloudrun-addon
   

2. Im Terminal werden Sie vom Migrationsskript aufgefordert, jede Aktion zu bestätigen. Geben Sie y ein, um den Vorgang zu starten und bei jeder Eingabeaufforderung fortzufahren.

   Die Eingabeaufforderungen während der Deinstallation des „GKE Add-ons“ sehen etwa so aus:

   In this process, the script performs the following:
   1. Validating the node pool to make sure it meets the requirements for
      upgrading. Confirming node pool requirements for
      my-gcp-project/us-central1-c/my-gke-cluster...
   2. Applying the required migration labels
      namespace/knative-serving labeled
   3. Create a ValidatingWebhookConfiguration admission webhook to prevent
      the deletion of resources under the following namespaces:
      knative-serving, cloud-run-system, and gke-system
   Continue? [Y/n] y
   
   validatingwebhookconfiguration.admissionregistration.k8s.io/prevent-deletion-cloud-run-resources created
   ValidatingWebhookConfiguration prevent-deletion-cloud-run-resources for preventing deleting Cloud Run for Anthos resources is effective.
   
   4. Uninstall the Cloud Run for Anthos GKE add-on? Your
   Cloud Run for Anthos resources remain in your cluster.
   Continue? [Y/n] y
   
   Updating my-gke-cluster...
   
   5. Removing the add-on manager labels and adding the Operator related
     annotations. This step will take about 10 minutes.
   
   customresourcedefinition.apiextensions.k8s.io/certificates.networking.internal.knative.dev annotated
   
   6. Clean up unused stale Cloud Run for Anthos operator.
   
   cloudrun.operator.run.cloud.google.com "cloud-run" deleted
   No resources found
   
   Cloud Run for Anthos GKE add-on is successfully uninstalled.
   

3. Prüfen Sie mit dem folgenden Befehl, ob das „GKE-Add-on“ disabled lautet:

   gcloud container clusters describe ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID} --format='get(addonsConfig.cloudRunConfig.disabled)'
   

   True wird zurückgegeben, wenn das „GKE-Add-on“ erfolgreich aus Ihrem Cluster entfernt wurde.

Nächste Schritte

Zu Anthos Service Mesh migrieren

Rollback

Wenn Sie ein Rollback der oben beschriebenen Schritte durchführen müssen, können Sie das Migrationsskript für Folgendes verwenden:

• Aktivieren Sie das „GKE-Add-on“ für Cloud Run for Anthos wieder.
• Entfernen Sie den Zulassungs-Webhook ValidatingWebhookConfiguration.

So starten Sie den Rollback-Prozess:

1. Starten Sie das Migrationsskript mit dem folgenden Befehl:

   ./migration-addon.sh --command rollback-uninstall-cloudrun-addon
   

2. Im Terminal werden Sie vom Migrationsskript aufgefordert, jede Aktion zu bestätigen. Geben Sie bei jeder Eingabeaufforderung y ein, um fortzufahren.

   Die Eingabeaufforderungen während der erneuten Aktivierung des „GKE-Add-ons“ sehen etwa so aus:

   In this step, the script performs the following:
     1. Enable Cloud Run for Anthos GKE add-on
     2. Remove the ValidatingWebhookConfiguration added for uninstalling addon
   Continue? [Y/n] Y
   
   1. Enable Cloud Run for Anthos GKE add-on?
   Continue? [Y/n] Y
   
   Updating my-gke-cluster...done.
   Cloud Run for Anthos GKE add-on is enabled
   
   2. Remove the ValidatingWebhookConfiguration added for uninstalling addon?
   Continue? [Y/n] Y
   
   Removing the ValidatingWebhookConfiguration used to prevent deletion
   

3. Prüfen Sie, ob das „GKE-Add-on“ für Cloud Run for Anthos wieder aktiviert ist:

   gcloud container clusters describe ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID} --format='get(addonsConfig.cloudRunConfig)'
   

   Wenn das Add-on in Ihrem Cluster installiert ist, werden die Konfigurationsdetails für das Add-on zurückgegeben. Beispiel:

   loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL