Disinstalla il componente aggiuntivo GKE di Knative serving

Disinstalla il "componente aggiuntivo GKE" di Knative serving dal cluster, incluse le risorse e le etichette correlate.

In questa attività, lo script di migrazione viene utilizzato per rimuovere solo il "componente aggiuntivo GKE" dal cluster. Tutte le risorse di Knative serving esistenti rimangono nel cluster e continuano a gestire il traffico.

Prima di iniziare

• Devi prima esaminare e assicurarti di soddisfare i requisiti per l'upgrade.

• I comandi in questa pagina utilizzano le variabili di ambiente e lo script di migrazione dal passaggio di preparazione dell'upgrade.

• È importante eseguire ogni passaggio di questa procedura nell' ordine specificato.

Panoramica

La disinstallazione del componente aggiuntivo GKE include:

1. Verifica che il pool di nodi soddisfi i requisiti per l'upgrade.
2. Applicazione delle etichette di migrazione e creazione del webhook di ammissione ValidatingWebhookConfiguration per impedire l'eliminazione delle risorse di Knative serving nei seguenti spazi dei nomi:
   • knative-serving
   • cloud-run-system
   • gke-system

3. Disinstallazione del "componente aggiuntivo GKE", inclusa la rimozione delle etichette del gestore correlate dalle risorse di Knative serving.

   Tieni presente che questa procedura può essere eseguita per più di 10 minuti.

4. Aggiunta delle annotazioni appdevexperience-operator.

5. Rimozione della risorsa cloudrun.operator.run.cloud.google.com obsoleta che non viene utilizzata con i fleet.

Nota: anche se il traffico verso i servizi rimane invariato, il nodo del control plane GKE ("master") viene aggiornato e, di conseguenza, diventa temporaneamente non disponibile durante la procedura. Le operazioni che richiedono l'accesso al piano di controllo GKE, come le operazioni sulle risorse Kubernetes (eliminazione, aggiornamento o creazione), non verranno eseguite fino al completamento dell'aggiornamento.

Disinstallare il componente aggiuntivo GKE di Knative serving

In questa sezione, lo script di migrazione viene utilizzato per disinstallare il "componente aggiuntivo GKE".

1. Esegui il comando seguente per avviare lo script di migrazione:

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

2. Nel terminale, lo script di migrazione ti chiede di confermare l'esecuzione di ogni azione. Inserisci y per avviare la procedura e continuare a ogni prompt.

   I prompt durante la procedura di disinstallazione del "componente aggiuntivo GKE" sono simili ai seguenti:

   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. Verifica che il "componente aggiuntivo GKE" sia stato disabled eseguendo il comando seguente:

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

   Viene restituito True se il "componente aggiuntivo GKE" è stato rimosso correttamente dal cluster.

Passaggi successivi

Esegui la migrazione a Cloud Service Mesh

Esegui il rollback

Se devi eseguire il rollback delle modifiche apportate tramite i passaggi precedenti, puoi utilizzare lo script di migrazione per:

• Riattivare il "componente aggiuntivo GKE" di Knative serving.
• Rimuovere il webhook di ammissione ValidatingWebhookConfiguration.

Per avviare la procedura di rollback:

1. Esegui il comando seguente per avviare lo script di migrazione:

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

2. Nel terminale, lo script di migrazione ti chiede di confermare l'esecuzione di ogni azione. Inserisci y a ogni prompt per continuare.

   I prompt durante la procedura di riattivazione del "componente aggiuntivo GKE" sono simili ai seguenti:

   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. Verifica che il "componente aggiuntivo GKE" di Knative serving sia stato riattivato:

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

   Se il componente aggiuntivo è in esecuzione nel cluster, vengono restituiti i dettagli di configurazione del componente aggiuntivo. Esempio:

   loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL