Migrer un cluster vers Istio sur un nouveau cluster
Ce tutoriel explique comment migrer une application d'un cluster Google Kubernetes Engine (GKE) existant utilisant Cloud Service Mesh intégré au cluster vers un nouveau cluster GKE utilisant Istio Open Source. Vous allez exploiter les fonctionnalités de maillage de la périphérie au multicluster pour une migration fluide.
Remarque sur la terminologie : Dans ce tutoriel, Cloud Service Mesh fait référence à Cloud Service Mesh intégré au cluster de Google, et Istio fait référence au maillage de services Istio Open Source.
Au cours de ce tutoriel, vous allez :
- Préparer votre cluster existant avec Cloud Service Mesh intégré au cluster pour la migration.
- Provisionner un nouveau cluster GKE avec Istio.
- Configurer l'API Gateway multicluster GKE sur un cluster dédié et des services multiclusters pour configurer le routage vers l'entrée du maillage.
- Exécuter un déploiement Canary pour répartir le trafic HTTP en direct entre Cloud Service Mesh et Istio.
- Effectuer le basculement final vers Istio et mettre hors service les ressources Cloud Service Mesh intégrées au cluster.
Déploiement Canary
Le "déploiement Canary" est une technique utilisée en ingénierie logicielle pour tester une nouvelle version d'un logiciel ou d'une infrastructure avant de la publier pour tous les utilisateurs en production. Il s'agit d'augmenter progressivement le pourcentage de trafic envoyé à la nouvelle version cible.
Dans ce tutoriel, vous allez configurer un nouveau cluster avec Istio et y transférer progressivement le trafic utilisateur. Vous commencerez par diriger 0% du trafic utilisateur vers le nouveau cluster, puis 50 % et, enfin, 100% vers le cluster GKE avec Istio. Dans les environnements de production, vous pouvez utiliser des incréments plus petits et plus précis (par exemple, 1%, 5%, 10%, 25%, 50%, 100%). Si, à un moment donné, vous constatez que le nouveau cluster présente des erreurs ou une dégradation des performances, vous pouvez effectuer un rollback immédiat en rétablissant le pourcentage de trafic à 0% pour le cluster Istio.
Plan de contrôle Canary ou cluster Canary
Il existe deux stratégies principales pour migrer entre les plans de contrôle du maillage de services :
- Migration vers un cluster Canary (recommandée) : dans cette stratégie, vous créez un nouveau cluster dans le même Google Cloud projet et le même parc que votre cluster existant, vous y installez le plan de contrôle du maillage de services cible (Istio), puis vous migrez les charges de travail et le trafic entrant vers le nouveau cluster.
- Migration vers un plan de contrôle Canary (non prise en charge) : dans cette stratégie, vous installez le nouveau plan de contrôle côte à côte sur le même cluster que celui où le plan de contrôle initial est installé. Ce mode de migration n'est pas pris en charge.
Dans ce guide, vous allez suivre la stratégie de migration vers un cluster Canary. Les deux clusters doivent résider dans le même Google Cloud projet.
Coûts
Ce tutoriel fait appel à des composants payants de Google Cloud, y compris :
- Google Kubernetes Engine
- Une passerelle multicluster et des services multiclusters
- Cloud Load Balancing
Une fois que vous aurez terminé ce tutoriel, évitez de payer des frais en supprimant les ressources que vous avez créées. Pour en savoir plus, consultez la section Libérer de l'espace.
Avant de commencer
-
Dans la Google Cloud console, sur la page de sélection du projet, sélectionnez le Google Cloud projet dans lequel Cloud Service Mesh intégré au cluster est installé.
- Connectez-vous à votre Google Cloud compte. Si vous n'avez jamais utilisé Google Cloud, créez un compte pour évaluer les performances de nos produits dans des scénarios réels. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.
-
Verify that billing is enabled for your Google Cloud project.
Enable the required APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
Verify that billing is enabled for your Google Cloud project.
Enable the required APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
Préparer le cluster à l'aide de Cloud Service Mesh intégré au cluster pour la migration
Dans cette section, vous allez préparer votre cluster GKE existant exécutant Cloud Service Mesh intégré au cluster pour la migration vers un cluster GKE avec Istio.
S'assurer que le cluster Cloud Service Mesh intégré au cluster est en cours d'exécution et prêt pour la migration
Assurez-vous que votre cluster Cloud Service Mesh intégré au cluster
GKE_CSM_CLUSTERest en cours d'exécution avec le plan de contrôleistiodintégré au cluster, conformément au guide d'installation de Cloud Service Mesh intégré au cluster.Exécutez la commande suivante pour vérifier l'état de l'installation :
kubectl get deployment -A -l app=istiod -L istio.io/revLe résultat ressemble à ce qui suit :
NAMESPACE NAME READY UP-TO-DATE AVAILABLE AGE REV ISTIOD_NAMESPACE istiod-asm-1295-12 2/2 2 2 4d16h asm-1295-12Vérifiez qu'il n'y a pas d'erreur dans le plan de contrôle
istiodà l'aide de la commande suivante :kubectl logs -n ISTIOD_NAMESPACE -l app=istiod
Préparer le cluster pour la migration
Vérifiez que Workload Identity est activé sur le cluster et le pool de nœuds.
Pour vérifier Workload Identity sur le cluster, exécutez la commande suivante :
gcloud container clusters describe "GKE_CSM_CLUSTER" \ --location="LOCATION" \ --project="PROJECT_ID" \ --format="value(workloadIdentityConfig.workloadPool)"Remplacez GKE_CSM_CLUSTER par le nom de votre cluster existant, LOCATION par l'emplacement de votre cluster et PROJECT_ID par l'ID de votre projet.
Résultat attendu :
PROJECT_ID.svc.id.googSi Workload Identity est manquant, consultez le guide Workload Identity pour mettre à jour votre cluster.
Vérifiez que votre cluster est enregistré dans le parc :
gcloud container clusters describe "GKE_CSM_CLUSTER" \ --location="LOCATION" \ --project="PROJECT_ID" \ --format="yaml(fleet)"Résultat attendu pour un cluster enregistré :
fleet: membership: //gkehub.googleapis.com/projects/PROJECT_NUMBER/locations/LOCATION/memberships/MEMBERSHIP_NAMESi les détails du parc sont vides, consultez le guide d'enregistrement de l'appartenance au parc pour enregistrer votre cluster dans le parc.
Exposez votre application à l'aide d'une passerelle d'Ingress en suivant le guide d'installation et de mise à niveau de la passerelle.
Installer Istio sur un nouveau cluster GKE
Dans cette section, vous allez provisionner un nouveau cluster GKE exécutant Istio Open Source pour la stratégie de migration vers un cluster Canary.
Créez un nouveau cluster GKE
GKE_ISTIO_CLUSTERdans le même Google Cloud projet (PROJECT_ID) que votre cluster Cloud Service Mesh intégré au cluster existant.Lors de la création du cluster, assurez-vous de spécifier
--projectet d'activer Workload Identity à l'aide de--workload-pool=PROJECT_ID.svc.id.goog:gcloud container clusters create GKE_ISTIO_CLUSTER \ --project=PROJECT_ID \ --location=LOCATION \ --workload-pool=PROJECT_ID.svc.id.googSi vous avez déjà créé un cluster, utilisez le guide Workload Identity pour activer Workload Identity.
Enregistrez votre cluster Istio dans le parc :
gcloud container fleet memberships register \ GKE_ISTIO_CLUSTER \ --gke-cluster=LOCATION/GKE_ISTIO_CLUSTER \ --enable-workload-identity \ --location=LOCATION \ --project=PROJECT_IDInstallez Istio en suivant le guide d'installation officiel d'Istio avec des passerelles d'entrée déployées pour le trafic entrant. Pour une migration plus fluide, nous vous recommandons d'installer la même version d'Istio Open Source. Si vous décidez de mettre à niveau Istio Open Source, consultez les notes de version d'Istio pour connaître les changements de comportement.
Configurez ce cluster en installant vos applications de la même manière que sur le cluster GKE à l'aide de Cloud Service Mesh intégré au cluster. Ce guide fait référence à l'espace de noms hébergeant les passerelles d'entrée en tant que
ISTIO_INGRESS_NAMESPACE.Assurez-vous que le cluster est sain et prêt à traiter le trafic. Les équipes d'application sont chargées de vérifier que tous les microservices s'exécutent correctement et réussissent les vérifications de l'état avant de router le trafic utilisateur en direct.
Configurer l'API Gateway multicluster sur un cluster dédié
Dans cette section, vous allez configurer un équilibreur de charge d'application externe (L7XLB) via le GKE Gateway Controller pour activer le trafic entrant vers le maillage. Lors de la migration, nous vous recommandons de déployer des ressources de l'API Gateway sur un cluster de configuration GKE dédié pour gérer l'équilibreur de charge. Ce guide fait référence à ce cluster de configuration dédié en tant que GKE_CONFIG_CLUSTER.
Préparer le cluster de configuration
Préparez le cluster de configuration pour héberger les API Gateway et HTTPRoute en suivant le
guide de la passerelle multicluster.
Exporter des services à l'aide de services multiclusters
Exportez le service istio-ingressgateway sur les deux clusters de maillage à l’aide de
ServiceExport comme indiqué dans le
guide des services multiclusters
(MCS) :
apiVersion: net.gke.io/v1
kind: ServiceExport
metadata:
namespace: NAMESPACE
name: SERVICE_EXPORT_NAME
Provisionner des ressources de l'API Gateway sur le cluster de configuration
Suivez le guide Gateway Edge-to-Mesh pour créer les ressources
GatewayetHTTPRoutesur votre cluster de configuration dédié. Un exemple de configuration se présente comme suit :apiVersion: gateway.networking.k8s.io/v1 kind: Gateway metadata: name: global-gateway namespace: CSM_INGRESS_NAMESPACE spec: gatewayClassName: gke-l7-global-external-managed-mc listeners: - name: http protocol: HTTP port: 80 allowedRoutes: namespaces: from: Same --- apiVersion: gateway.networking.k8s.io/v1 kind: HTTPRoute metadata: name: edge-to-mesh-route namespace: CSM_INGRESS_NAMESPACE spec: parentRefs: - name: global-gateway rules: - backendRefs: # Backend 1: Cloud Service Mesh Cluster (CSM_INGRESS_NAMESPACE namespace) - group: net.gke.io kind: ServiceImport name: istio-ingressgateway namespace: CSM_INGRESS_NAMESPACE port: 80 weight: 100Si vos
ServiceImportressources résident dans un espace de noms différent deHTTPRoute, utilisezReferenceGrantpour activer le routage du trafic entre les espaces de noms :apiVersion: gateway.networking.k8s.io/v1beta1 kind: ReferenceGrant metadata: name: allow-csm-ingress-to-ISTIO_INGRESS_NAMESPACE namespace: ISTIO_INGRESS_NAMESPACE spec: from: - group: gateway.networking.k8s.io kind: HTTPRoute namespace: CSM_INGRESS_NAMESPACE to: - group: net.gke.io kind: ServiceImport
Migrer le trafic à l'aide d'un déploiement Canary
Dans cette section, vous allez transférer le trafic vers le nouveau cluster et terminer la migration.
Transférer 50% du trafic vers Istio
Dans cette section, vous allez exécuter un déploiement Canary pour migrer lentement le trafic. Pour en savoir plus, consultez le guide sur la répartition du trafic.
Appliquez la ressource personnalisée
HTTPRoutedans le cluster de configuration pour répartir le trafic Canary vers le cluster Istio :apiVersion: gateway.networking.k8s.io/v1 kind: HTTPRoute metadata: name: edge-to-mesh-route namespace: CSM_INGRESS_NAMESPACE spec: parentRefs: - name: global-gateway rules: - backendRefs: # Backend 1: CSM Cluster (CSM_INGRESS_NAMESPACE namespace) - group: net.gke.io kind: ServiceImport name: istio-ingressgateway namespace: CSM_INGRESS_NAMESPACE port: 80 weight: 50 # Backend 2: Istio Cluster (ISTIO_INGRESS_NAMESPACE namespace) - group: net.gke.io kind: ServiceImport name: istio-ingressgateway namespace: ISTIO_INGRESS_NAMESPACE port: 80 weight: 50Validez la distribution du trafic en direct en exécutant des requêtes parallèles sur l'adresse IP publique de la passerelle.
Résultat attendu : les réponses sont équilibrées entre
GKE_CSM_CLUSTERetGKE_ISTIO_CLUSTER.En production, comme indiqué précédemment, migrez le trafic par petits incréments (par exemple, 1%, 5%, 10%, 25%, 50%, 100%). La propagation complète de ces incréments de poids vers l'équilibreur de charge peut prendre un certain temps. Vérifiez donc que le trafic est correctement réparti avant d'augmenter davantage.
Terminer la migration vers le cluster Istio
Vérifiez que l'application sur le cluster Istio fonctionne correctement sous le trafic Canary et que tout le trafic a été transféré vers celui-ci. Une fois que vous avez confirmé que le routage du trafic fonctionne correctement, terminez la migration en supprimant la ressource ServiceExport sur le cluster Cloud Service Mesh intégré au cluster :
kubectl --context="GKE_CSM_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n CSM_INGRESS_NAMESPACE
Le GKE Gateway Controller dissocie automatiquement le groupe de points de terminaison du réseau (NEG) du cluster Cloud Service Mesh du service de backend de l'équilibreur de Google Cloud charge. Tout le trafic client entrant passe de manière transparente au cluster Istio sans temps d'arrêt.
Libérer de l'espace
Pour éviter que les ressources utilisées dans ce tutoriel ne soient facturées sur votre Google Cloud compte, nettoyez les composants déployés.
Supprimez les ressources
ServiceExportsur le cluster Istio :kubectl --context="GKE_ISTIO_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n ISTIO_INGRESS_NAMESPACEAnnulez l'enregistrement des appartenances au parc :
gcloud container fleet memberships unregister \ GKE_CSM_CLUSTER \ --gke-cluster="LOCATION/GKE_CSM_CLUSTER" \ --project="PROJECT_ID"Supprimez le cluster Cloud Service Mesh intégré au cluster :
gcloud container clusters delete GKE_CSM_CLUSTER \ --location="LOCATION" \ --project="PROJECT_ID"
Étape suivante
- Lisez le guide d'architecture de base : De la périphérie au réseau multicluster : déployez des applications distribuées à l'échelle mondiale via GKE Gateway et Cloud Service Mesh.
- En savoir plus sur les modèles d'API Gateway multicluster.
- En savoir plus sur l'équilibrage de charge multicluster.
- Consultez la documentation sur la gestion du trafic de maillage Istio .