Desinstala el complemento de GKE de Knative serving

Desinstala el “complemento de GKE” de Knative serving de tu clúster, incluidos los recursos relacionados y las etiquetas.

En esta tarea, la secuencia de comandos de migración se usa para quitar solo el “complemento de GKE” de tu clúster; todos tus recursos existentes de Knative serving permanecerán en el clúster y seguirán 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

Desinstalar el complemento de GKE incluye lo siguiente:

1. Validar que el grupo de nodos cumple con los requisitos para la actualización
2. Aplicar etiquetas de migración y crear el webhook de admisión ValidatingWebhookConfiguration para evitar que tus 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”, lo que incluye quitar las etiquetas de administrador relacionadas de tus recursos de Knative serving

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

4. Agregando las anotaciones appdevexperience-operator

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

Nota: Si bien el tráfico a tus servicios no se ve afectado, el nodo del plano de control de GKE (“master”) se actualiza y, por lo tanto, deja de estar disponible de forma temporal durante el proceso. Cualquier operación que requiera acceso al plano de control de GKE, como las operaciones de recursos de Kubernetes (borrar, actualizar o crear), no se producirá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 instrucción.

   Los mensajes durante el proceso de desinstalación del “complemento de GKE” se ven similares a los 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 de tu 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 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 solicitudes 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 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 ejecuta en tu clúster, se muestran los detalles de configuración para el complemento. Ejemplo:

   loadBalancerType=LOAD_BALANCER_TYPE_EXTERNAL