Effectuer une migration d'un cluster vers un cluster géré, sur un nouveau cluster

Ce tutoriel explique comment migrer une application depuis un cluster Google Kubernetes Engine (GKE) vers un nouveau cluster à l'aide d'Anthos Service Mesh dans le cluster, vers un nouveau cluster à l'aide d'Anthos Service Mesh géré, le maillage de services entièrement géré de Google et conforme à Istio.

Dans ce tutoriel, vous allez :

1. Créez un cluster Google Kubernetes Engine, puis installez Anthos Service Mesh dans le cluster et la passerelle d'entrée Anthos Service Mesh sur le cluster. Ce cluster servira de cluster existant pour lequel vous ne souhaitez plus être migré.
2. Déployez l'exemple d'application Online Boutique sur le cluster avec Anthos Service Mesh dans le cluster.
3. Créer un autre cluster Google Kubernetes Engine dans le même projet Google Cloud
4. Provisionnez le service Anthos Service Mesh géré sur le deuxième cluster et déployez la passerelle d'entrée Anthos Service Mesh.
5. Déployez Online Boutique sur le cluster avec Anthos Service Mesh géré pour répliquer le déploiement à partir du cluster avec Anthos Service Mesh dans le cluster.
6. Transférez 50% du trafic utilisateur du cluster incluant Anthos Service Mesh vers le cluster avec Anthos Service Mesh géré, en utilisant les fonctionnalités de répartition du trafic d'Istio sur le cluster doté d'Anthos Service Mesh dans le cluster.
7. Terminez la migration d'Anthos Service Mesh dans le cluster vers Anthos Service Mesh géré en faisant pointer l'entrée du système de noms de domaine (DNS) du cluster avec Anthos Service Mesh dans le cluster vers le cluster avec Anthos Service Mesh géré.

Déploiement Canary

Le "déploiement Canary" est une technique utilisée dans le développement de logiciels pour tester une nouvelle version d'un logiciel avant de la publier auprès de tous les utilisateurs. Cela implique une augmentation incrémentale du pourcentage de trafic envoyé vers la nouvelle version. Dans ce tutoriel, vous allez configurer un nouveau cluster avec Anthos Service Mesh géré et y transférer progressivement le trafic utilisateur. Vous allez commencer par diriger 0% du trafic utilisateur vers le nouveau cluster, puis 50 % et, enfin, 100%. En production, utilisez des incréments plus petits et plus nombreux. Si, à un moment donné, vous remarquez que le nouveau cluster est incapable de gérer un pourcentage du trafic, vous pouvez effectuer un rollback en réduisant ce pourcentage à 0%.

Plan de contrôle Canary et cluster Canary

Il existe deux stratégies couramment utilisées pour les migrations d'Anthos Service Mesh dans un cluster vers un service Anthos Service Mesh géré:

• Migration du plan de contrôle Canary: dans cette stratégie, vous provisionnez Anthos Service Mesh géré sur le cluster dans lequel vous avez actuellement installé Anthos Service Mesh dans le cluster.
• Migration d'un cluster Canary: dans cette stratégie, vous créez un cluster, puis y provisionnez Anthos Service Mesh géré.

Dans ce tutoriel, vous allez découvrir la stratégie de migration d'un cluster Canary.

Coûts

Ce tutoriel utilise les composants facturables suivants de Google Cloud :

• Google Kubernetes Engine
• Anthos Service Mesh

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 Effectuer un nettoyage.

Avant de commencer

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

4. Activez les API requises.

   Activer les API

5. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

6. Vérifiez que la facturation est activée pour votre projet Google Cloud.

7. Activez les API requises.

   Activer les API

Lancer Cloud Shell

Dans ce tutoriel, vous allez utiliser Cloud Shell, un environnement shell hébergé sur Google Cloud, qui vous permet de gérer vos ressources Google Cloud.

Cloud Shell est préinstallé sur les outils de ligne de commande Google Cloud CLI, kubectl et istioctl. La gcloud CLI fournit la CLI principale pour Google Cloud.

Ouvrez une session Cloud Shell en haut à droite de cette page, cliquez sur , puis sur Confirmer. Une session Cloud Shell s'ouvre dans un cadre situé plus bas sur la page. Exécutez les commandes suivantes dans cette session Cloud Shell.

Télécharger l'exemple de code

Clonez les dépôts Git contenant les ressources Kubernetes et Istio que vous allez utiliser:

  git clone https://github.com/GoogleCloudPlatform/anthos-service-mesh-samples.git
  git clone https://github.com/GoogleCloudPlatform/microservices-demo.git

Configurer le cluster avec Anthos Service Mesh dans le cluster

Créer le cluster et installer Anthos Service Mesh dans le cluster

Dans la section, vous allez créer un cluster qui utilise Anthos Service Mesh dans le cluster. En pratique, il s'agit du ou des clusters que vous utilisez déjà.

1. Remplacez PROJECT_ID par votre ID de projet et créez un cluster:

   gcloud container clusters create cluster-with-in-cluster-asm \
     --project=PROJECT_ID \
     --zone=us-central1-a \
     --machine-type=e2-standard-4 --num-nodes=2 \
     --workload-pool=PROJECT_ID.svc.id.goog
   

   Remarque :Cette opération peut prendre quelques minutes.

2. Renommez le contexte du cluster pour faciliter son utilisation:

   kubectl config rename-context \
     gke_PROJECT_ID_us-central1-a_cluster-with-in-cluster-asm \
     cluster-with-in-cluster-asm
   

3. Vérifiez que le contexte du cluster a été renommé:

   kubectl config get-contexts --output="name"
   

4. Téléchargez la version qui installe Anthos Service Mesh dans le répertoire de travail actuel :

   curl https://storage.googleapis.com/csm-artifacts/asm/ > asmcli
   

   Vous serez invité à saisir "y", puis à appuyer sur Entrée.

   Le résultat est semblable à :

   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
   100  167k  100  167k    0     0   701k      0 --:--:-- --:--:-- --:--:--  701k
   

5. Rendez le script asmcli exécutable:

   chmod +x asmcli
   

6. Installez Anthos Service Mesh dans le cluster à l'aide de asmcli:

   ./asmcli install \
     --project_id PROJECT_ID \
     --cluster_name cluster-with-in-cluster-asm \
     --cluster_location us-central1-a \
     --output_dir . \
     --enable_all \
     --ca mesh_ca
   

   L'exécution de l'outil asmcli peut prendre plusieurs minutes. L'outil génère des messages d'information pour que vous puissiez suivre sa progression.

   En cas de réussite, le résultat ressemble à ce qui suit:

   ...
   asmcli: Successfully installed ASM.
   

Déployer la passerelle d'entrée Anthos Service Mesh

1. Vous allez déployer la passerelle d'entrée d'Anthos Service Mesh dans un espace de noms distinct appelé asm-ingress. Créez l'espace de noms:

   kubectl \
     --context cluster-with-in-cluster-asm \
     create namespace asm-ingress
   

2. Utilisez le libellé istio.io/rev= pour ajouter l'espace de noms asm-ingress au maillage de services et activer l'injection automatique du proxy side-car.

   kubectl \
     --context cluster-with-in-cluster-asm \
     label --overwrite namespace asm-ingress istio.io/rev=
   

   Le résultat est semblable à :

   namespace/asm-ingress labeled
   

   Remarque :Vous devrez peut-être modifier le libellé istio.io/rev= pour qu'il corresponde à la version Anthos Service Mesh de votre cluster. Vous pouvez voir la version portant le suffixe du nom de votre service istiod-asm-* en exécutant la commande kubectl get service --context=cluster-with-in-cluster-asm --namespace=istio-system.

3. Déployez la passerelle d'entrée Anthos Service Mesh:

   kubectl \
     --context cluster-with-in-cluster-asm \
     --namespace=asm-ingress \
     apply -f anthos-service-mesh-samples/docs/shared/asm-ingress-gateway/asm-gateway-deployment-svc.yaml
   kubectl \
     --context cluster-with-in-cluster-asm \
     --namespace=asm-ingress \
     apply -f anthos-service-mesh-samples/docs/shared/asm-ingress-gateway/gateway.yaml
   

   Le résultat est semblable à :

   serviceaccount/asm-ingressgateway created
   service/asm-ingressgateway created
   deployment.apps/asm-ingressgateway created
   gateway.networking.istio.io/asm-ingressgateway created
   

   Remarque :Vous pouvez parcourir les ressources du dépôt GitHub officiel d'exemples Anthos Service Mesh.

Déployer Online Boutique

1. Vous allez déployer Online Boutique dans un espace de noms distinct appelé onlineboutique. Créez l'espace de noms:

   kubectl \
     --context cluster-with-in-cluster-asm \
     create namespace onlineboutique
   

2. Utilisez le libellé istio.io/rev= pour ajouter l'espace de noms onlineboutique au maillage de services et activer l'injection automatique du proxy side-car.

   kubectl \
     --context cluster-with-in-cluster-asm \
     label --overwrite namespace onlineboutique istio.io/rev=
   

   Le résultat est semblable à :

   namespace/onlineboutique labeled
   

3. Déployez les 12 services d'Online Boutique, y compris le générateur de charge qui imite le trafic utilisateur:

   kubectl \
     --context cluster-with-in-cluster-asm \
     --namespace=onlineboutique \
     apply -f anthos-service-mesh-samples/docs/shared/online-boutique/kubernetes-manifests.yaml
   kubectl \
     --context cluster-with-in-cluster-asm \
     --namespace=onlineboutique \
     apply -f anthos-service-mesh-samples/docs/shared/online-boutique/virtual-service.yaml
   

4. Obtenez l'adresse IP publique de la passerelle d'entrée Anthos Service Mesh:

   kubectl \
     --context cluster-with-in-cluster-asm \
     --namespace asm-ingress \
     get service --output jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}'
   

5. Copiez l'adresse IP publique de la passerelle d'entrée et accédez-y via votre navigateur Web. L'application exemple Online Boutique s'affiche.

Configurer le nouveau cluster avec Anthos Service Mesh géré

Créer le cluster et provisionner le service Anthos Service Mesh géré

Dans cette section, vous allez créer le cluster vers lequel vous allez migrer. Vous allez provisionner un service Anthos Service Mesh géré et déployer Online Boutique afin de répliquer les déploiements à partir du cluster qui utilise Anthos Service Mesh dans le cluster.

1. Stockez votre numéro de projet dans une variable d'environnement:

   export PROJECT_NUMBER=$(gcloud projects \
     describe PROJECT_ID --format='get(projectNumber)')
   

   Remarque :L'utilisation d'un seul projet Google Cloud pour les deux clusters n'est pas obligatoire dans le cadre de la stratégie de migration des clusters Canary. En pratique, vous pouvez créer votre cluster dans un projet Google Cloud distinct.

2. Créez un cluster :

   gcloud container clusters create cluster-with-managed-asm \
     --project=PROJECT_ID --zone=us-central1-a \
     --machine-type=e2-standard-4 --num-nodes=2 \
     --workload-pool PROJECT_ID.svc.id.goog \
     --labels mesh_id=proj-${PROJECT_NUMBER}
   

   Remarque :Cette opération peut prendre quelques minutes.

3. Renommez le contexte du cluster pour faciliter son utilisation:

   kubectl config rename-context \
     gke_PROJECT_ID_us-central1-a_cluster-with-managed-asm \
     cluster-with-managed-asm
   

4. Vérifiez que le contexte du cluster a été renommé:

   kubectl config get-contexts --output="name"
   

5. Activez Anthos Service Mesh sur le parc de votre projet. Un parc est un regroupement logique de clusters Kubernetes et d'autres ressources pouvant être gérés ensemble.

   gcloud container fleet mesh enable --project PROJECT_ID
   

   Le résultat est semblable à :

   Waiting for Feature Service Mesh to be created...done.
   

6. Enregistrez le cluster dans le parc du projet :

   gcloud container fleet memberships register cluster-with-managed-asm-membership \
     --gke-cluster=us-central1-a/cluster-with-managed-asm \
     --enable-workload-identity \
     --project PROJECT_ID
   

   Le résultat est semblable à :

   Waiting for membership to be created...done.
   Created a new membership [projects/your-project-id/locations/global/memberships/cluster-with-gke-membership] for the cluster [cluster-with-gke-membership]
   Generating the Connect Agent manifest...
   Deploying the Connect Agent on cluster [cluster-with-gke-membership] in namespace [gke-connect]...
   Deployed the Connect Agent on cluster [cluster-with-gke-membership] in namespace [gke-connect].
   Finished registering the cluster [cluster-with-gke-membership] with the Fleet.
   

7. Activez Anthos Service Mesh géré sur le cluster:

   gcloud container fleet mesh update \
     --management automatic \
     --memberships cluster-with-managed-asm-membership \
     --project PROJECT_ID
   

   Le résultat est semblable à :

   Waiting for Feature Service Mesh to be updated...done.
   

   Remarque :Anthos Service Mesh géré se charge d'une grande partie de la maintenance manuelle associée à la mise à niveau, au scaling et à la sécurisation de votre maillage de services. Apprenez-en plus sur le service Anthos Service Mesh géré.

8. Vérifiez qu'Anthos Service Mesh géré a été provisionné pour le cluster et est prêt à être utilisé:

   gcloud container fleet mesh describe --project PROJECT_ID
   

   Il peut s'écouler environ 10 minutes avant qu'Anthos Service Mesh ne soit provisionné et prêt à être utilisé sur le cluster. Si controlPlaneManagement.state: DISABLED ou controlPlaneManagement.state: PROVISIONING s'affiche, vous devez relancer la commande précédente toutes les deux ou trois minutes jusqu'à ce que controlPlaneManagement.state: ACTIVE s'affiche.

   Le résultat est semblable à :

   createTime: '2022-07-06T01:05:39.110120474Z'
   membershipSpecs:
     projects/123456789123/locations/global/memberships/cluster-with-managed-asm-membership:
       mesh:
         management: MANAGEMENT_AUTOMATIC
   membershipStates:
     projects/123456789123/locations/global/memberships/cluster-with-managed-asm-membership:
       servicemesh:
         controlPlaneManagement:
           details:
           - code: REVISION_READY
             details: 'Ready: asm-managed'
           state: ACTIVE
         dataPlaneManagement:
           details:
           - code: OK
             details: Service is running.
           state: ACTIVE
       state:
         code: OK
         description: 'Revision(s) ready for use: asm-managed.'
         updateTime: '2022-07-06T01:19:24.243993678Z'
   name: projects/your-project-id/locations/global/features/servicemesh
   resourceState:
     state: ACTIVE
   spec: {}
   state:
     state: {}
   updateTime: '2022-07-06T01:19:27.475885687Z'
   

Déployer la passerelle d'entrée Anthos Service Mesh

1. Vous allez déployer la passerelle d'entrée d'Anthos Service Mesh dans un espace de noms distinct appelé asm-ingress. Créez l'espace de noms:

   kubectl \
     --context cluster-with-managed-asm \
     create namespace asm-ingress
   

2. Utilisez le libellé istio.io/rev=asm-managed pour ajouter l'espace de noms asm-ingress au maillage de services et activer l'injection automatique du proxy side-car.

   kubectl \
     --context cluster-with-managed-asm \
     label namespace asm-ingress 'istio.io/rev=asm-managed'
   

3. Déployez la passerelle d'entrée Anthos Service Mesh:

   kubectl \
     --context cluster-with-managed-asm \
     --namespace=asm-ingress \
     apply -f anthos-service-mesh-samples/docs/shared/asm-ingress-gateway/asm-gateway-deployment-svc.yaml
   kubectl \
     --context cluster-with-managed-asm \
     --namespace=asm-ingress \
     apply -f anthos-service-mesh-samples/docs/shared/asm-ingress-gateway/gateway.yaml
   

   Le résultat est semblable à :

   namespace/asm-ingress configured
   serviceaccount/asm-ingressgateway configured
   service/asm-ingressgateway configured
   deployment.apps/asm-ingressgateway configured
   gateway.networking.istio.io/asm-ingressgateway configured
   

   Remarque :Vous pouvez parcourir les ressources du dépôt GitHub officiel d'exemples Anthos Service Mesh.

Déployer Online Boutique

1. Vous allez déployer Online Boutique dans un espace de noms distinct appelé onlineboutique. Créez l'espace de noms:

   kubectl \
     --context cluster-with-managed-asm \
     create namespace onlineboutique
   

2. Utilisez le libellé istio.io/rev=asm-managed pour ajouter l'espace de noms onlineboutique au maillage de services et activer l'injection automatique du proxy side-car.

   kubectl \
     --context cluster-with-managed-asm \
     label namespace onlineboutique 'istio.io/rev=asm-managed'
   

3. Déployez les 12 services d'Online Boutique, y compris le générateur de charge qui imite le trafic utilisateur:

   kubectl \
     --context cluster-with-managed-asm \
     --namespace=onlineboutique \
     apply -f anthos-service-mesh-samples/docs/shared/online-boutique/kubernetes-manifests.yaml
   kubectl \
     --context cluster-with-managed-asm \
     --namespace=onlineboutique \
     apply -f anthos-service-mesh-samples/docs/shared/online-boutique/virtual-service.yaml
   

4. Obtenez l'adresse IP publique de la passerelle d'entrée Anthos Service Mesh:

   kubectl \
     --context cluster-with-managed-asm \
     --namespace asm-ingress \
     get service --output jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}'
   

5. Copiez l'adresse IP publique du service asm-ingressgateway et accédez-y via votre navigateur Web. L'application exemple Online Boutique s'affiche. Vous utiliserez l'adresse IP publique dans la section suivante. Copiez-la dans une variable d'environnement:

   export INGRESS_IP_OF_CLUSTER_WITH_MANAGED_ASM=$( \
     kubectl \
       --context cluster-with-managed-asm \
       --namespace asm-ingress \
       get service --output jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}' \
     )
   

Tester le cluster avec Anthos Service Mesh à l'aide d'un déploiement Canary

Dans cette section, vous allez configurer le cluster avec Anthos Service Mesh dans le cluster, de sorte que 50% du trafic utilisateur vers Online Boutique soit transféré vers l'instance Online Boutique sur le cluster avec Anthos Service Mesh géré. Pour ce faire, vous devez déployer deux ressources Istio sur le cluster avec Anthos Service Mesh dans le cluster:

• Une entrée ServiceEntry pour indiquer à Anthos Service Mesh dans le cluster le point de terminaison de la boutique en ligne du cluster Anthos Service Mesh géré
• un VirtualService pour indiquer à la passerelle d'entrée Anthos Service Mesh dans le cluster de répartir le trafic par 50-50.

Remarque :En production, cette répartition du trafic entre le cluster avec Anthos Service Mesh géré doit être effectuée par petits incréments (au lieu de 50 % immédiatement) et être progressivement augmentée jusqu'à 100%.

1. Définissez l'adresse IP de la passerelle d'entrée du cluster Anthos Service Mesh géré dans la ressource ServiceEntry:

   sed -i "s/1.2.3.4/${INGRESS_IP_OF_CLUSTER_WITH_MANAGED_ASM}/" anthos-service-mesh-samples/docs/migrate-to-managed-asm/service-entry.yaml
   

2. Déployez ServiceEntry sur le cluster avec Anthos Service Mesh dans le cluster:

   kubectl \
     --context cluster-with-in-cluster-asm \
     --namespace onlineboutique \
     apply -f anthos-service-mesh-samples/docs/migrate-to-managed-asm/service-entry.yaml
   

3. Déployez VirtualService sur le cluster avec Anthos Service Mesh dans le cluster:

   kubectl \
     --context cluster-with-in-cluster-asm \
     --namespace onlineboutique \
     apply -f anthos-service-mesh-samples/docs/migrate-to-managed-asm/virtual-service-in-cluster-asm.yaml
   

4. Accédez à l'adresse IP de la passerelle d'entrée du cluster avec Anthos Service Mesh dans le cluster, dans votre navigateur Web:

   kubectl \
     --context cluster-with-in-cluster-asm \
     --namespace asm-ingress \
     get service
   

   Actualisez plusieurs fois la page d'accueil de la boutique en ligne et vérifiez le pied de page à chaque fois. Notez que 50% des requêtes sont traitées par un pod du cluster avec Anthos Service Mesh géré.

Migrer vers le cluster avec Anthos Service Mesh géré

Dans cette section, nous partons du principe que vous possédez un nom de domaine et que vous avez accès à ses paramètres DNS (Domain Name Server).

1. Ajoutez un enregistrement A aux paramètres DNS pour faire pointer le nom de domaine (tel que example.com) vers l'adresse IP de la passerelle d'entrée exécutée sur le cluster avec Anthos Service Mesh dans le cluster.

   Remarque :Cette opération peut prendre quelques minutes.

2. Accédez à Online Boutique en accédant au nom de domaine dans votre navigateur Web.

3. Réduisez la valeur TTL (Time To Live) de l'enregistrement DNS pour pouvoir rapidement rétablir l'entrée DNS si vous devez effectuer un rollback.

4. Définissez l'enregistrement A de votre nom de domaine sur l'adresse IP publique de la passerelle d'entrée du cluster avec Anthos Service Mesh géré.

5. Une fois la migration effectuée, supprimez le cluster avec Anthos Service Mesh dans le cluster:

   gcloud container clusters delete cluster-with-in-cluster-asm \
     --zone=us-central1-a \
     --project=PROJECT_ID
   

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans ce tutoriel soient facturées sur votre compte Google Cloud, supprimez le projet contenant les ressources, ou conservez le projet et supprimez les ressources individuellement.

Supprimer le projet

Attention : La suppression d'un projet aura les effets suivants :
• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches de ce document, lorsque vous le supprimez, vous supprimez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.
1. Dans la console Google Cloud, accédez à la page Gérer les ressources.

   Accéder à la page Gérer les ressources

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Supprimer les ressources

Supprimez le cluster avec Anthos Service Mesh géré:

  gcloud container clusters delete cluster-with-managed-asm \
    --zone=us-central1-a \
    --project=PROJECT_ID

Étapes suivantes

• Apprenez-en plus sur le service Anthos Service Mesh géré.
• Découvrez les bonnes pratiques de sécurité pour Anthos Service Mesh.