Estos pasos son específicos para las instalaciones de Istio on GKE, también conocido como "complemento Istio".
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.
Identificar si se está usando el complemento de Istio
Hay dos posibles rutas de migración, en función de si se usa la función de inyección de sidecar o de gateway de entrada del complemento de Istio en tu clúster.
En el paso de preparación anterior, ya has identificado si el complemento Istio está configurado. Puedes ejecutar el siguiente comando para verificar que existe el espacio de nombres
istio-system
:echo $INGRESS_NAMESPACE
Ejecuta el siguiente comando para determinar si la función de inyección de sidecar del complemento Istio se está usando en tu clúster:
kubectl get ns -l istio-injection=enabled
Si se indica algún espacio de nombres que no sea
knative-serving
, significa que se está usando la inyección de sidecar del complemento de Istio.Por ejemplo, si el comando solo muestra el espacio de nombres
knative-serving
, significa que no has configurado ni usas la inyección de sidecar del complemento Istio.
Resultados:
Se ha usado una o ambas: se está usando una o ambas funciones del complemento Istio en tu clúster:
- Se usa el servicio de entrada del complemento Istio
istio-ingressgateway
. - Se usa la inyección de sidecar del complemento Istio.
Pasos siguientes: después de seguir las instrucciones de la siguiente sección para desinstalar el complemento Istio, debes consultar la guía Cloud Service Mesh con el plano de control gestionado.
- Se usa el servicio de entrada del complemento Istio
No se usa: ni la pasarela de entrada ni la inyección de sidecar del complemento de Istio están configuradas para usarse en tu clúster. En otras palabras, tu instalación usa la "versión empaquetada de Istio".
Pasos siguientes: Después de seguir las instrucciones de la siguiente sección para desinstalar el complemento de Istio que no se utiliza, puedes consultar la guía sobre Cloud Service Mesh con el plano de control en el clúster.
Desinstalar el complemento Istio
En esta sección, se usa la secuencia de comandos de migración para desinstalar el complemento de Istio.
Ejecuta el siguiente comando para iniciar la secuencia de comandos de migración:
./migration-addon.sh --command uninstall-istio-addon
Verifica que se ha eliminado el espacio de nombres
istio-system
:kubectl get ns istio-system --ignore-not-found
Siguientes pasos
En función de la configuración de la pasarela de entrada que hayas identificado anteriormente, consulta la guía de instalación correspondiente:
Si has identificado anteriormente que una o ambas funciones del complemento de Istio se han configurado y utilizado en tu clúster, debes consultar la guía Cloud Service Mesh con el plano de control gestionado.
Si has identificado anteriormente que no se ha usado la pasarela de entrada ni la inyección de sidecar del complemento de Istio en tu clúster, significa que tu instalación ha usado la versión empaquetada de Istio. Ahora puedes instalar Cloud Service Mesh con el plano de control en el clúster.
Restauración
Si necesitas deshacer los cambios que has realizado siguiendo los pasos anteriores, puedes usar la secuencia de comandos de migración para volver a habilitar el complemento Istio:
Ejecuta el siguiente comando:
./migration-addon.sh --command rollback-uninstall-istio-addon
Para seguir revirtiendo los cambios a la instalación original, revierte el complemento de servicio de Knative de GKE.