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 fonctionnalité de passerelle d'entrée ou d'injection side-car du module complémentaire Istio est utilisée 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 module complémentaire Istio utilise le service d'entrée
istio-ingressgateway
. - L'injection side-car du module complémentaire Istio est utilisée.
Étapes suivantes: après avoir suivi les instructions de la section suivante pour désinstaller le module complémentaire Istio, vous devez accéder au guide Cloud Service Mesh avec le plan de contrôle géré.
- Le module complémentaire Istio utilise 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ées pour être utilisées dans votre cluster. En d'autres termes, votre installation utilise la "version intégrée d'Istio".
Étapes suivantes: après avoir suivi les instructions de la section suivante pour désinstaller le module complémentaire Istio inutilisé, vous pouvez passer au guide Cloud Service Mesh avec le plan de contrôle intégré au cluster.
Désinstaller le module complémentaire Istio
Dans cette section, le script de migration est utilisé pour 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
Étapes suivantes
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 ou les deux fonctionnalités du module complémentaire Istio ont été configurées et utilisées dans votre cluster, vous devez consulter le guide Cloud Service Mesh avec le 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 procéder à l'installation de Cloud Service Mesh avec le plan de contrôle 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 ci-dessous.
./migration-addon.sh --command rollback-uninstall-istio-addon
Pour continuer à effectuer un rollback des modifications vers l'état d'origine de votre installation, effectuez le rollback du module complémentaire Knative serving "GKE".