Desinstala Cloud Service Mesh

Nota: Esta guía solo es compatible con Cloud Service Mesh con las APIs de Istio y no con las APIs de Google Cloud. Para obtener más información, consulta Descripción general de Cloud Service Mesh.

En esta página, se explica cómo desinstalar Cloud Service Mesh si estás usando las APIs de Istio. Si usas las API de Compute Engine, no es necesario realizar pasos. Consulta la descripción general de Cloud Service Mesh para comprender las diferencias.

Advertencia: Si sigues estas instrucciones para desinstalar Cloud Service Mesh, se quitarán todos los parámetros de configuración, sin importar el tipo de plano de control (en el clúster o administrado).

Desinstala Cloud Service Mesh

Usa los siguientes comandos para desinstalar todos los componentes de Cloud Service Mesh. Por medio de estos comandos, también se borran el espacio de nombres istio-system y todas las definiciones de los recursos personalizados (CRD), incluidas las CRD que aplicaste.

Advertencia: Si creaste CRD, asegúrate de tener copias de ellas antes de continuar con los siguientes pasos.

1. Para evitar la interrupción del tráfico de la aplicación:

   • Cambia las políticas STRICT de mTLS a PERMISSIVE.
   • Quita cualquier AuthorizationPolicy que pueda bloquear el tráfico.

2. Inhabilita la administración automática en este clúster (ya sea que la hayas aplicado directamente o con la configuración predeterminada de la flota):

     gcloud container fleet mesh update \
        --management manual \
        --memberships MEMBERSHIP_NAME \
        --project FLEET_PROJECT_ID \
        --location MEMBERSHIP_LOCATION
   

   Reemplaza lo siguiente:

   • MEMBERSHIP_NAME es el nombre de la membresía que aparece cuando verificaste que tu clúster se registró en la flota.
   • MEMBERSHIP_LOCATION es la ubicación de tu membresía (ya sea una región o global).

3. Inhabilita la inserción automática de sidecar en tus espacios de nombres, si está habilitada. Ejecuta el siguiente comando para mostrar las etiquetas de espacio de nombres:

    kubectl get namespace YOUR_NAMESPACE --show-labels
   

   El resultado es similar al siguiente:

    NAME   STATUS   AGE     LABELS
    demo   Active   4d17h   istio.io/rev=asm-181-5

   Si ves istio.io/rev= en el resultado en la columna LABELS, quítalo:

    kubectl label namespace YOUR_NAMESPACE istio.io/rev-
   

   Si ves istio-injection en el resultado en la columna LABELS, quítalo:

    kubectl label namespace YOUR_NAMESPACE istio-injection-
   

   Si no ves las etiquetas istio.io/rev o istio-injection, la inyección automática no se habilitó en el espacio de nombres.

4. Reinicia tus cargas de trabajo que tienen incorporados sidecars para quitar los proxies.

5. Si usas Cloud Service Mesh administrado, verifica qué implementación del plano de control tienes en tu clúster. Esto ayudará a borrar los recursos relevantes en los próximos pasos.

6. Si usas Cloud Service Mesh administrado, quita todos los recursos controlplanerevision del clúster:

   kubectl delete controlplanerevision asm-managed asm-managed-rapid asm-managed-stable -n istio-system --ignore-not-found=true
   

7. Borra los webhooks del clúster, si existen.

   Malla de servicios de Cloud en el clúster

   Borra la validatingwebhooksconfiguration y la mutatingwebhookconfiguration.

   kubectl delete validatingwebhookconfiguration,mutatingwebhookconfiguration -l operator.istio.io/component=Pilot
   

   Malla de servicios de Cloud administrada

   A. Borra la validatingwebhooksconfiguration.

   kubectl delete validatingwebhookconfiguration istiod-istio-system-mcp
   

   B. Borrar todos los mutatingwebhookconfiguration.

   Nota: Usa RELEASE_CHANNEL de acuerdo con el canal de versiones que aprovisionaste. Por ejemplo, Regular(istiod-asm-managed), Rápido (istiod-asm-managed-rapid) y Estable (istiod-asm-managed-stable).

   kubectl delete mutatingwebhookconfiguration istiod-RELEASE_CHANNEL
   

8. Una vez que aparezcan todas las cargas de trabajo y no se vean proxies, puedes borrar de forma segura el plano de control en el clúster para detener la facturación.

   Para quitar el plano de control en el clúster, ejecuta el siguiente comando:

   istioctl x uninstall --purge
   

   Si no hay otros planos de control, puedes borrar el espacio de nombres istio-system para deshacerte de todos los recursos de Cloud Service Mesh. De lo contrario, borra los servicios correspondientes a las revisiones de Cloud Service Mesh. Esto evita borrar recursos compartidos, como CRD.

9. Borra los espacios de nombres istio-system y asm-system:

    kubectl delete namespace istio-system asm-system --ignore-not-found=true
   

10. Verifica si las eliminaciones se realizaron de forma correcta:

     kubectl get ns
    

    El resultado debe indicar un estado Terminating y mostrarlo como se indica a continuación. De lo contrario, es posible que debas borrar de forma manual los recursos restantes en el espacio de nombres y volver a intentarlo.

     NAME                 STATUS       AGE
     istio-system         Terminating  71m
     asm-system           Terminating  71m
    

11. Si borrarás tus clústeres o ya los borraste, asegúrate de que cada uno de ellos no esté registrado en tu flota.

12. Si habilitaste la configuración predeterminada de la flota administrada de Cloud Service Mesh y deseas inhabilitarla para los clústeres futuros, inhabilítala. Puedes omitir este paso si solo desinstalas desde un único clúster.

     gcloud container hub mesh disable --fleet-default-member-config --project FLEET_PROJECT_ID
    

    En el que FLEET_PROJECT_ID es el ID del proyecto host de la flota.

13. Si usas Cloud Service Mesh administrado, borra la implementación mdp-controller:

     kubectl delete deployment mdp-controller -n kube-system
    

14. Si usas Cloud Service Mesh administrado y tienes la implementación del plano de control TRAFFIC_DIRECTOR, limpia los recursos de la Verificación de estado transparente. Por lo general, estos se quitan automáticamente, pero para asegurarte de que se borran, sigue estos pasos:

    A. Borra el daemonset snk.

     kubectl delete daemonset snk -n kube-system
    

    B. Borra la regla de firewall.

     gcloud compute firewall-rules delete gke-csm-thc-FIRST_8_CHARS_OF_CLUSTER_ID
    

    Reemplaza lo siguiente:

    • FIRST_8_CHARS_OF_CLUSTER_ID son los primeros 8 caracteres del ID de clúster para tu clúster específico.

15. Verifica si el ConfigMap istio-cni-plugin-config está presente:

     kubectl get configmap istio-cni-plugin-config -n kube-system
    

    Si está presente, borra el configmap istio-cni-plugin-config:

     kubectl delete configmap istio-cni-plugin-config -n kube-system
    

    Advertencia: La confiabilidad de la red de tu clúster de GKE puede verse afectada si no borras este ConfigMap.

16. Borra el daemonset istio-cni-node:

     kubectl delete daemonset istio-cni-node -n kube-system
    

17. Si desinstalas Cloud Service Mesh administrado y conservas tu clúster, comunícate con el equipo de asistencia para asegurarte de que todos los recursos de Google Cloud estén limpios. Si no sigues este paso, es posible que también se sigan recreando el espacio de nombres istio-system y los mapas de configuración.

Una vez que se completan estos pasos, todos los componentes de Cloud Service Mesh, incluidos los proxies, las autoridades certificadas en el clúster y las funciones y vinculaciones de RBAC, se quitan del clúster de forma sistemática. Durante el proceso de instalación, a una cuenta de servicio propiedad de Google se le otorgan los permisos necesarios para establecer los recursos de la malla de servicios dentro del clúster. Estas instrucciones de desinstalación no revocan estos permisos, lo que permitirá una reactivación sin problemas de Cloud Service Mesh en el futuro.