Disinstalla il componente aggiuntivo GKE 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 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 del passaggio di preparazione dell'upgrade.

• È importante eseguire ogni passaggio nell'ordine specificato.

Panoramica

La disinstallazione del componente aggiuntivo GKE include:

1. Convalida della conformità del pool di nodi ai requisiti per l'upgrade.
2. Applicazione delle etichette di migrazione e creazione del webhook di ammissione ValidatingWebhookConfiguration per impedire che le risorse Knative serving vengano eliminate nei seguenti spazi dei nomi:
   • knative-serving
   • cloud-run-system
   • gke-system

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

   Tieni presente che questo processo può durare più di 10 minuti.

4. Aggiunta delle annotazioni appdevexperience-operator in corso...

5. Rimozione della risorsa cloudrun.operator.run.cloud.google.com inattiva che non viene utilizzata con i parchi risorse.

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

Disinstalla il componente aggiuntivo GKE Knative serving

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

1. Esegui questo comando per avviare lo script di migrazione:

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

2. Nel terminale, lo script di migrazione richiede la conferma per eseguire ogni azione. Inserisci y per iniziare il processo e anche per continuare a ogni richiesta.

   I prompt durante il processo 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 disabled eseguendo questo comando:

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

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

Passaggi successivi

Eseguire 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:

• Riattiva il "componente aggiuntivo GKE" di Knative serving.
• Rimuovi il webhook di ammissione ValidatingWebhookConfiguration.

Per avviare il processo di rollback:

1. Esegui questo comando per avviare lo script di migrazione:

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

2. Nel terminale, lo script di migrazione richiede la conferma per eseguire ogni azione. Per continuare, inserisci y a ogni richiesta.

   I prompt durante il processo 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 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