Ces étapes sont spécifiques aux installations d'Istio sur GKE, également appelé module complémentaire Istio.
Avant de commencer
Vous devez d'abord vérifier que vous remplissez les conditions requises pour la mise à niveau.
Les commandes de cette page utilisent les variables d'environnement et le script de migration de l'étape de préparation de la mise à niveau.
Il est important d'effectuer chaque étape de ce processus dans l'ordre spécifié.
Déterminer si le module complémentaire Istio est utilisé
Il existe deux chemins de migration possibles, selon que la passerelle d'entrée ou la fonctionnalité d'injection sidecar du module complémentaire Istio sont utilisées dans votre cluster.
Plus tôt dans l'étape de préparation, vous avez déjà déterminé si le module complémentaire Istio était configuré. Vous pouvez exécuter la commande suivante pour vérifier si l'espace de noms
istio-system
existe :echo $INGRESS_NAMESPACE
Exécutez la commande suivante pour déterminer si la fonctionnalité d'injection side-car du module complémentaire Istio est utilisée dans votre cluster :
kubectl get ns -l istio-injection=enabled
Si un espace de noms autre que
knative-serving
s'affiche, cela indique que l'injection side-car du module complémentaire Istio est utilisée.Par exemple, si la commande n'affiche que l'espace de noms
knative-serving
, cela signifie que vous n'avez pas configuré et n'utilisez pas l'injection side-car du module complémentaire Istio.
Résultats :
Une ou deux fonctionnalités sont utilisées : l'une des fonctionnalités ou les deux fonctionnalités du module complémentaire Istio sont utilisées dans votre cluster :
- Le service d'entrée
istio-ingressgateway
du module complémentaire Istio est utilisé. - L'injection side-car du module complémentaire Istio est utilisée.
Étapes suivantes : après avoir suivi les instructions de la prochaine section pour désinstaller le module complémentaire Istio, vous devez passer au guide Cloud Service Mesh avec un plan de contrôle géré par Google.
- Le service d'entrée
Non utilisé : ni la passerelle d'entrée, ni l'injection side-car du module complémentaire Istio ne sont configurés pour être utilisés dans votre cluster. En d'autres termes, votre installation utilise la "version groupée d'Istio".
Étapes suivantes : après avoir suivi les instructions de la prochaine section pour désinstaller le module complémentaire Istio non utilisé, vous pouvez passer au guide Cloud Service Mesh avec un plan de contrôle au sein du cluster.
Désinstaller le module complémentaire Istio
Dans cette section, le script de migration permet de désinstaller le module complémentaire Istio.
Exécutez la commande suivante pour démarrer le script de migration :
./migration-addon.sh --command uninstall-istio-addon
Vérifiez que l'espace de noms
istio-system
a été supprimé :kubectl get ns istio-system --ignore-not-found
Étape suivante
En fonction de la configuration de passerelle d'entrée que vous avez identifiée ci-dessus, passez au guide d'installation correspondant :
Si vous avez identifié précédemment qu'une des fonctionnalités du module complémentaire Istio ou les deux ont été configurées et utilisées dans votre cluster, vous devez consulter le guide Cloud Service Mesh avec un plan de contrôle géré.
Si vous avez identifié précédemment que ni la passerelle d'entrée, ni l'injection side-car du "module complémentaire Istio" n'ont été utilisées dans votre cluster, votre installation a utilisé la "version groupée d'Istio". Vous pouvez maintenant installer Cloud Service Mesh avec le plan de contrôle au sein du cluster.
Rollback
Si vous devez effectuer un rollback des modifications que vous avez apportées en suivant les étapes ci-dessus, vous pouvez utiliser le script de migration pour réactiver le module complémentaire Istio :
Exécutez la commande suivante :
./migration-addon.sh --command rollback-uninstall-istio-addon
Pour retrouver l'état d'origine de votre installation, effectuez un rollback du "module complémentaire GKE" de Knative serving.