Disinstalla il componente aggiuntivo GKE di Knative serving

Disinstalla il "componente aggiuntivo GKE" 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 tuo cluster. Tutte le risorse Knative Serving esistenti rimangono nel cluster e continuano a gestire il traffico.

Prima di iniziare

Panoramica

La disinstallazione del componente aggiuntivo di GKE include:

  1. Convalida 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ò durare 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 le flotte.

Disinstalla il componente aggiuntivo GKE di 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 ti chiede di confermare l'esecuzione di ogni azione. Inserisci y per iniziare la procedura e per continuare a ogni prompt.

    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 stato 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

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:

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

Per avviare la procedura 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 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 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