Déployer l'exemple de Bookinfo

Cette page explique comment déployer un exemple d'application sur Anthos Service Mesh. Si vous n'avez pas installé Anthos Service Mesh, consultez le guide d'installation.

Plusieurs exemples d'applications sont fournis avec l'installation d'Anthos Service Mesh. Ce guide montre comment déployer l'exemple d'application BookInfo. Il s'agit d'une application de librairie factice simple, composée de quatre services fournissant une page produits Web, des informations sur les livres, des avis de lecteurs (avec plusieurs versions du service de communication d'avis) et des évaluations. Tous sont gérés à l'aide d'Anthos Service Mesh. Vous trouverez le code source et tous les autres fichiers utilisés dans cet exemple dans le répertoire d'installation d'Anthos Service Mesh sous samples/bookinfo.

Activer l'injection side-car automatique

Pour activer l'injection automatique, vous devez ajouter un libellé à vos espaces de noms en utilisant les libellés d'injection par défaut, si le tag par défaut est configuré, ou bien le libellé de révision. Le libellé que vous ajoutez varie selon que vous avez déployé Anthos Service Mesh géré ou que vous avez installé le plan de contrôle intégré au cluster. Le webhook d'injecteur side-car utilise le libellé pour associer les side-cars injectés à une révision spécifique du plan de contrôle.

Dans le cluster

Exécutez la commande suivante pour localiser le libellé de révision sur istiod :
```
kubectl -n istio-system get pods -l app=istiod --show-labels
```
La sortie ressemble à ceci :
```
NAME                                READY   STATUS    RESTARTS   AGE   LABELS
istiod-asm-173-3-5788d57586-bljj4   1/1     Running   0          23h   app=istiod,istio.io/rev=asm-1146-16,istio=istiod,pod-template-hash=5788d57586
istiod-asm-173-3-5788d57586-vsklm   1/1     Running   1          23h   app=istiod,istio.io/rev=asm-1146-16,istio=istiod,pod-template-hash=5788d57586
```
Dans le résultat, sous la colonne LABELS, notez la valeur du libellé de révision istiod, qui suit le préfixe istio.io/rev=. Dans cet exemple, la valeur est asm-1146-16.

Remarque : Vous pouvez remplacer istio.io/rev par le libellé istio-injection=enabled si le tag par défaut est configuré. Vérifiez que le tag par défaut existe en exécutant la commande istioctl tag list avec le fichier istioctl à partir de OUTPUT_DIR.
Appliquez le libellé de révision à l'espace de noms par défaut. Dans la commande suivante, REVISION correspond à la valeur du libellé de révision istiod que vous avez notée à l'étape précédente.
```
kubectl label namespace default istio-injection- istio.io/rev=REVISION --overwrite
```
Vous pouvez ignorer le message "istio-injection not found" dans le résultat. Cela signifie que l'espace de noms ne portait pas précédemment le libellé istio-injection, auquel on s'attend dans de nouvelles installations d'Anthos Service Mesh ou de nouveaux déploiements. Comme l'injection automatique échoue si un espace de noms possède à la fois le libellé istio-injection et le libellé de révision, toutes les commandes kubectl label de la documentation Anthos Service Mesh spécifient explicitement les deux libellés.

Maillage de services géré

Appliquez le libellé de révision asm-managed-regular à l'espace de noms default :
```
kubectl label namespace default istio-injection- istio.io/rev=asm-managed-regular --overwrite
```
Ce libellé correspond à la version disponible d'Anthos Service Mesh géré pour la version d'Anthos Service Mesh.

Remarque : Vous pouvez remplacer istio.io/rev par le libellé istio-injection=enabled si le tag par défaut est configuré. Vérifiez que le tag par défaut existe en exécutant la commande istioctl tag list avec le fichier istioctl à partir de OUTPUT_DIR.
Si vous avez également déployé le plan de données géré facultatif, annotez l'espace de noms demo comme suit :
```
kubectl annotate --overwrite namespace YOUR_NAMESPACE \
mesh.cloud.google.com/proxy='{"managed":"true"}'
```

Déployer l'application

Maintenant que l'injection automatique est activée sur l'espace de noms default, lorsque vous déployez les services de l'application BookInfo, les proxys side-car sont injectés avec chaque service.

Sur la ligne de commande de l'ordinateur sur lequel vous avez installé Anthos Service Mesh, accédez à la racine du répertoire d'installation d'Anthos Service Mesh. Si nécessaire, téléchargez le fichier d'installation.
Déployez votre application sur l'espace de noms par défaut à l'aide de kubectl :
```
kubectl apply -f samples/bookinfo/platform/kube/bookinfo.yaml
```

Confirmez que l'application a été correctement déployée en exécutant les commandes suivantes :

kubectl get services

Résultat :

NAME                       CLUSTER-IP   EXTERNAL-IP   PORT(S)              AGE
details                    10.0.0.31    <none>        9080/TCP             6m
kubernetes                 10.0.0.1     <none>        443/TCP              7d
productpage                10.0.0.120   <none>        9080/TCP             6m
ratings                    10.0.0.15    <none>        9080/TCP             6m
reviews                    10.0.0.170   <none>        9080/TCP             6m

kubectl get pod

Résultat :

NAME                                        READY     STATUS    RESTARTS   AGE
details-v1-1520924117-48z17                 2/2       Running   0          6m
productpage-v1-560495357-jk1lz              2/2       Running   0          6m
ratings-v1-734492171-rnr5l                  2/2       Running   0          6m
reviews-v1-874083890-f0qf0                  2/2       Running   0          6m
reviews-v2-1343845940-b34q5                 2/2       Running   0          6m
reviews-v3-1813607990-8ch52                 2/2       Running   0          6m

Enfin, définissez le routage de la passerelle d'entrée pour l'application :

kubectl apply -f samples/bookinfo/networking/bookinfo-gateway.yaml

Résultat :

gateway.networking.istio.io/bookinfo-gateway created
virtualservice.networking.istio.io/bookinfo created

Valider le déploiement de l'application

Pour vérifier si l'application Bookinfo fonctionne, vous devez envoyer du trafic à la passerelle d'entrée.

Si vous avez installé Anthos Service Mesh sur GKE sur VMware, obtenez l'adresse IP externe de la passerelle d'entrée que vous avez configurée après avoir installé Anthos Service Mesh.

Si vous avez installé Anthos Service Mesh sur GKE, obtenez l'adresse IP externe de la passerelle d'entrée comme suit :

kubectl get service istio-ingressgateway -n istio-system

Sortie :

NAME                   TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                                      AGE
istio-ingressgateway   LoadBalancer   10.19.247.233   35.239.7.64   80:31380/TCP,443:31390/TCP,31400:31400/TCP   27m

Dans cet exemple, l'adresse IP du service d'entrée est 35.239.7.64.

Essayer l'application

Vérifiez que l'application Bookinfo s'exécute avec curl :
```
curl -I http://EXTERNAL_IP/productpage
```
Si la réponse indique 200, cela signifie que l'application fonctionne correctement avec Anthos Service Mesh.
Pour afficher la page Web de Bookinfo, saisissez l'adresse suivante dans votre navigateur :
```
http://EXTERNAL_IP/productpage
```
Si vous actualisez la page plusieurs fois, vous devriez voir différentes versions d'avis affichées sur la page produits, chacune à tour de rôle (étoiles rouges, étoiles noires, aucune étoile).

Maintenant que vous disposez d'une application qui génère du trafic, vous pouvez explorer les pages Anthos Service Mesh dans la console Google Cloud pour consulter les métriques et les autres fonctionnalités d'observabilité.

Nettoyer

Lorsque vous avez terminé de tester l'exemple d'application Bookinfo, supprimez-le de votre cluster.

Désinstallez Bookinfo à l'aide du script suivant :
```
samples/bookinfo/platform/kube/cleanup.sh
```

Confirmez l'arrêt :

kubectl get virtualservices   #-- there should be no virtual services
kubectl get destinationrules  #-- there should be no destination rules
kubectl get gateway           #-- there should be no gateway
kubectl get pods              #-- the Bookinfo pods should be deleted

Étapes suivantes

Obtenez plus d'informations sur l'exemple d'application Bookinfo.