GKE-Add-on „Knative Serving“ deinstallieren

Deinstallieren Sie das „GKE-Add-on“ für Knative Serving 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 Knative Serving-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.

Übersicht

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 Knative Serving-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 Knative Serving-Ressourcen.

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

4. appdevexperience-operator-Annotationen hinzufügen.

5. Entfernen der veralteten cloudrun.operator.run.cloud.google.com-Ressource, die nicht mit 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.

GKE-Add-on für „Knative Serving“ 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 Knative serving resources is effective.
   
   4. Uninstall the Knative serving GKE add-on? Your
   Knative serving 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 Knative serving operator.
   
   cloudrun.operator.run.cloud.google.com "cloud-run" deleted
   No resources found
   
   Knative serving 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 Cloud 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 Knative Serving 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 Knative serving GKE add-on
     2. Remove the ValidatingWebhookConfiguration added for uninstalling addon
   Continue? [Y/n] Y
   
   1. Enable Knative serving GKE add-on?
   Continue? [Y/n] Y
   
   Updating my-gke-cluster...done.
   Knative serving 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 Knative Serving 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