Desinstalar el complemento de servicio de Knative de GKE

Desinstala el complemento de servicio de Knative "GKE add-on" de tu clúster, incluidos los recursos y las etiquetas relacionados.

En esta tarea, la secuencia de comandos de migración se usa para eliminar solo el complemento de GKE de tu clúster. Todos los recursos de servicio de Knative que tengas en el clúster permanecerán en él y seguirán sirviendo tráfico.

Antes de empezar

• Primero debes revisar y asegurarte de que cumples los requisitos para actualizar.

• Los comandos de esta página usan las variables de entorno y la secuencia de comandos de migración del paso de preparación de la actualización.

• Es importante que sigas cada paso de este proceso en el orden especificado.

Información general

Al desinstalar el complemento de GKE, se incluye lo siguiente:

1. Validando que el grupo de nodos cumple los requisitos para la actualización.
2. Aplicar etiquetas de migración y crear el webhook de admisión ValidatingWebhookConfiguration para evitar que se eliminen tus recursos de Knative Serving en los siguientes espacios de nombres:
   • knative-serving
   • cloud-run-system
   • gke-system

3. Desinstalar el complemento de GKE, lo que incluye eliminar las etiquetas de gestor relacionadas de tus recursos de servicio de Knative.

   Ten en cuenta que este proceso puede durar más de 10 minutos.

4. Añadiendo las anotaciones appdevexperience-operator.

5. Se ha quitado el recurso obsoleto cloudrun.operator.run.cloud.google.com que no se usa con las flotas.

Nota: Aunque el tráfico a tus servicios no se verá afectado, el nodo del plano de control de GKE ("master") se actualizará y, por lo tanto, no estará disponible temporalmente durante el proceso. No se podrán realizar operaciones que requieran acceso al plano de control de GKE, como las operaciones de recursos de Kubernetes (eliminar, actualizar o crear), hasta que se complete la actualización.

Desinstalar el complemento de servicio de Knative de GKE

En esta sección, se usa la secuencia de comandos de migración para desinstalar el complemento de GKE.

1. Ejecuta el siguiente comando para iniciar la secuencia de comandos de migración:

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

2. En el terminal, la secuencia de comandos de migración te pedirá que confirmes cada acción. Introduce y para iniciar el proceso y también para continuar en cada petición.

   Las peticiones que se muestran durante el proceso de desinstalación del "complemento de GKE" son similares a las siguientes:

   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. Comprueba que el complemento de GKE se haya disabled. Para ello, ejecuta el siguiente comando:

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

   Se devuelve True si el complemento GKE se ha quitado correctamente de tu clúster.

Siguientes pasos

Migrar a Cloud Service Mesh

Restauración

Si necesitas deshacer los cambios que has realizado siguiendo los pasos anteriores, puedes usar la secuencia de comandos de migración para hacer lo siguiente:

• Vuelve a habilitar el complemento de GKE de servicio de Knative.
• Elimina el webhook de admisión ValidatingWebhookConfiguration.

Para iniciar el proceso de restauración, sigue estos pasos:

1. Ejecuta el siguiente comando para iniciar la secuencia de comandos de migración:

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

2. En el terminal, la secuencia de comandos de migración te pedirá que confirmes cada acción. Introduce y en cada petición para continuar.

   Las peticiones que se muestran durante el proceso para volver a habilitar el complemento de GKE son similares a las siguientes:

   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. Comprueba que el complemento de GKE del servicio de Knative se haya vuelto a habilitar:

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

   Si el complemento se está ejecutando en tu clúster, se devolverán los detalles de configuración del complemento. Ejemplo:

   loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL