Désinstaller le module complémentaire GKE de Knative serving

Désinstallez le module complémentaire GKE de Knative serving depuis votre cluster, y compris les ressources et les libellés associés.

Dans cette tâche, le script de migration permet de ne supprimer que le module complémentaire GKE de votre cluster. L'ensemble de vos ressources Knative serving existantes sont conservées dans votre cluster et continuent à diffuser le trafic.

Avant de commencer

• Vous devez d'abord vérifier que vous remplissez les conditions requises pour la mise à niveau.

• Les commandes de cette page utilisent les variables d'environnement et le script de migration de l'étape de préparation de la mise à niveau.

• Il est important d'effectuer chaque étape de ce processus dans l'ordre spécifié.

Présentation

La désinstallation du module complémentaire GKE inclut les étapes suivantes :

1. La vérification que le pool de nœuds répond aux exigences de mise à niveau
2. L'application des libellés de migration et la création du webhook d'admission ValidatingWebhookConfiguration pour empêcher la suppression de vos ressources Knative serving dans les espaces de noms suivants :
   • knative-serving
   • cloud-run-system
   • gke-system

3. La désinstallation du module complémentaire GKE, y compris la suppression des libellés du gestionnaire associés de vos ressources Knative serving.

   Notez que ce processus peut prendre plus de 10 minutes.

4. L'ajout d'annotations appdevexperience-operator

5. La suppression de la ressource cloudrun.operator.run.cloud.google.com obsolète qui n'est pas utilisée avec les parcs.

Remarque : Même si le trafic acheminé sur vos services n'est pas impacté, le plan de contrôle GKE (maître) est mis à jour et devient donc indisponible pendant le processus. Les opérations nécessitant un accès au plan de contrôle GKE, telles que les opérations de suppression, de mise à jour ou de création de ressources Kubernetes, ne peuvent être effectuées qu'une fois la mise à jour terminée.

Désinstaller le module complémentaire GKE de Knative serving

Dans cette section, le script de migration permet de désinstaller le module complémentaire GKE.

1. Exécutez la commande suivante pour démarrer le script de migration :

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

2. Dans le terminal, le script de migration vous invite à confirmer chaque opération. Saisissez y pour commencer le processus et continuer à chaque invite.

   Les invites lors du processus de désinstallation du module complémentaire GKE se présentent comme suit :

   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. Vérifiez que le module complémentaire GKE a été défini sur disabled en exécutant la commande suivante :

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

   True est renvoyé si le module complémentaire GKE a bien été supprimé de votre cluster.

Étape suivante

Migrer vers Cloud Service Mesh

Rollback

Si vous devez effectuer un rollback des modifications que vous avez apportées en suivant les étapes ci-dessus, vous pouvez utiliser le script de migration pour :

• Réactiver le "module complémentaire GKE" de Knative serving.
• Supprimer le webhook d'admission ValidatingWebhookConfiguration.

Pour lancer le processus de rollback, procédez comme suit :

1. Exécutez la commande suivante pour démarrer le script de migration :

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

2. Dans le terminal, le script de migration vous invite à confirmer chaque opération. Saisissez y à chaque invite pour continuer.

   Les invites lors du processus de réactivation du module complémentaire GKE se présentent comme suit :

   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. Vérifiez que le module complémentaire GKE de Knative serving est réactivé :

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

   Si le module complémentaire est en cours d'exécution dans votre cluster, les détails de configuration du module complémentaire sont renvoyés. Exemple :

   loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL