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 :

  1. Préparer votre cluster existant avec Cloud Service Mesh intégré au cluster pour la migration.
  2. Provisionner un nouveau cluster GKE avec Istio.
  3. 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.
  4. Exécuter un déploiement Canary pour répartir le trafic HTTP en direct entre Cloud Service Mesh et Istio.
  5. 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 :

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

  1. 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é.

    Accéder au sélecteur de projet

  2. 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.
  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the required APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. 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.

    Enable the APIs

  5. Verify that billing is enabled for your Google Cloud project.

  6. Enable the required APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. 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.

    Enable the APIs

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

  1. Assurez-vous que votre cluster Cloud Service Mesh intégré au cluster GKE_CSM_CLUSTER est en cours d'exécution avec le plan de contrôle istiod inté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/rev
    

    Le 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-12
    
  2. Vé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

  1. 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.goog
    

    Si Workload Identity est manquant, consultez le guide Workload Identity pour mettre à jour votre cluster.

  2. 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_NAME
    

    Si les détails du parc sont vides, consultez le guide d'enregistrement de l'appartenance au parc pour enregistrer votre cluster dans le parc.

  3. 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.

  1. Créez un nouveau cluster GKE GKE_ISTIO_CLUSTER dans 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 --project et 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.goog
    

    Si vous avez déjà créé un cluster, utilisez le guide Workload Identity pour activer Workload Identity.

  2. 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_ID
    
  3. Installez 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.

  4. 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

  1. Suivez le guide Gateway Edge-to-Mesh pour créer les ressources Gateway et HTTPRoute sur 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: 100
    
  2. Si vos ServiceImport ressources résident dans un espace de noms différent de HTTPRoute, utilisez ReferenceGrant pour 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.

  1. Appliquez la ressource personnalisée HTTPRoute dans 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: 50
    
  2. Validez 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_CLUSTER et GKE_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.

  1. Supprimez les ressources ServiceExport sur le cluster Istio :

    kubectl --context="GKE_ISTIO_CLUSTER_CONTEXT" delete serviceexport.net.gke.io istio-ingressgateway -n ISTIO_INGRESS_NAMESPACE
    
  2. Annulez l'enregistrement des appartenances au parc :

    gcloud container fleet memberships unregister \
        GKE_CSM_CLUSTER \
        --gke-cluster="LOCATION/GKE_CSM_CLUSTER" \
        --project="PROJECT_ID"
    
  3. Supprimez le cluster Cloud Service Mesh intégré au cluster :

    gcloud container clusters delete GKE_CSM_CLUSTER \
        --location="LOCATION" \
        --project="PROJECT_ID"
    

Étape suivante