Desinstala el complemento de GKE de Knative serving

Desinstala el "Complemento de GKE" de Knative serving del clúster, incluidos los recursos y las etiquetas relacionados.

En esta tarea, se usará la secuencia de comandos de migración para quitar solo el “complemento de GKE” de tu clúster. El resto de recursos de Knative serving permanecen en el clúster y continúan entregando tráfico.

Antes de comenzar

• Primero, debes revisar y asegurarte de cumplir con los requisitos para actualizar.

• En los comandos de esta página, se 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 realices cada paso de este proceso en el orden especificado.

Descripción general

La desinstalación del complemento de GKE incluye lo siguiente:

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

3. Desinstalar el “complemento de GKE”, que incluye quitar las etiquetas del administrador relacionadas de los recursos de Knative serving.

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

4. Agregar las anotaciones appdevexperience-operator.

5. Quitar el recurso cloudrun.operator.run.cloud.google.com inactivo que no se usa con flotas.

Nota: Si bien el tráfico a tus servicios no se ve afectado, el nodo del plano de control de GKE ("instancia principal") se actualiza y, por lo tanto, deja de estar disponible temporalmente durante el proceso. Las operaciones que requieran acceso al plano de control de GKE, como las operaciones de recursos de Kubernetes, como borrar, actualizar o crear, no se realizarán hasta que se complete la actualización.

Desinstala el complemento de GKE de Knative serving

En esta sección, la secuencia de comandos de migración se usa 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 la terminal, la secuencia de comandos de migración te solicita tu confirmación para realizar cada acción. Ingresa y para comenzar el proceso y también para continuar en cada prompt.

   Las indicaciones 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. Ejecuta el siguiente comando para verificar que el “Complemento de GKE” sea disabled:

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

   Se muestra True si el "complemento de GKE" se quitó de forma correcta del clúster.

¿Qué sigue?

Migra a Cloud Service Mesh

Revertir

Si necesitas revertir los cambios que realizaste en los pasos anteriores, puedes usar la secuencia de comandos de migración para lo siguiente:

• Vuelve a habilitar el “complemento de GKE” de Knative serving.
• Quita el webhook de admisión de ValidatingWebhookConfiguration.

Para comenzar el proceso de reversión, haz lo siguiente:

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

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

2. En la terminal, la secuencia de comandos de migración te solicita tu confirmación para realizar cada acción. Ingresa y en cada mensaje para continuar.

   Las indicaciones durante el proceso de 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. Verifica que el complemento de GKE de Knative serving esté habilitado de nuevo:

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

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

   loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL