Déployer l'exemple de Bookinfo

Cette page explique comment déployer un exemple d'application Cloud Service Mesh. Si vous n'avez pas encore effectué d'intégration à Cloud Service Mesh, consultez la Guide de démarrage

Plusieurs exemples d'applications sont fournis avec l'installation de Cloud Service Mesh. Ce guide pas à pas pour déployer BookInfo échantillon. Il s'agit d'une simple application de librairie fictive composée de quatre services qui fournissent une page Web de produit, des informations détaillées sur un livre, des avis (avec plusieurs versions le service d'avis) et les notes, le tout géré à l'aide de Cloud Service Mesh. Vous trouverez le code source et tous les autres fichiers utilisés dans cet exemple dans le répertoire d'installation de Cloud Service Mesh sous samples/bookinfo.

Activer l'injection side-car automatique

Activez l'espace de noms pour l'injection : La procédure dépend de votre implémentation du plan de contrôle.
Géré (TD)
1. Appliquez le libellé d'injection par défaut à l'espace de noms :
```
kubectl label namespace default \
    istio.io/rev- istio-injection=enabled --overwrite
```
Géré (Istiod)
Recommandé:Exécutez la commande suivante pour appliquer l'étiquette d'injection par défaut à l'espace de noms:
```
  kubectl label namespace default \
      istio.io/rev- istio-injection=enabled --overwrite
```
Si vous êtes un utilisateur existant avec le plan de contrôle Istiod géré: Nous vous recommandons d'utiliser l'injection par défaut, mais celle basée sur les révisions compatibles. Pour ce faire, procédez comme suit:
1. Exécutez la commande suivante pour localiser les versions disponibles :
  kubectl -n istio-system get controlplanerevision
  Le résultat ressemble à ce qui suit :
  NAME AGE asm-managed-rapid 6d7h
  REMARQUE: Si deux révisions du plan de contrôle figurent dans la liste ci-dessus, supprimez-en une. Il n'est pas possible d'avoir plusieurs canaux de plan de contrôle dans le cluster.
  
  Dans le résultat, la valeur figurant dans la colonne NAME correspond au libellé de révision qui correspond à la version disponible disponible pour la version de Cloud Service Mesh.
2. Appliquez le libellé de révision à l'espace de noms.
  kubectl label namespace default \ istio-injection- istio.io/rev=REVISION_LABEL --overwrite
Dans le cluster
Recommandation : Exécutez la commande suivante pour appliquer le libellé d'injection par défaut à l'espace de noms :
```
  kubectl label namespace default \
      istio.io/rev- istio-injection=enabled --overwrite
```
Nous vous recommandons d'utiliser l'injection par défaut, mais l'injection basée sur les révisions est compatible: Pour ce faire, procédez comme suit:
1. Exécutez la commande suivante pour localiser le libellé de révision sur istiod :
  kubectl get deploy -n istio-system -l app=istiod -o \ jsonpath={.items[*].metadata.labels.'istio\.io\/rev'}'{"\n"}'
2. Appliquez le libellé de révision à l'espace de noms. Dans la commande suivante, REVISION_LABEL 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_LABEL --overwrite

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é Cloud Service Mesh, accédez à la racine du répertoire d'installation de Cloud Service Mesh. Si nécessaire, Téléchargez le fichier d'installation dans le cluster. qui inclut l'exemple d'application bookinfo, puis l'extraire.
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

Sortie :

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

Sortie :

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

Sortie :

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é Cloud Service Mesh sur Google Distributed Cloud (logiciel uniquement) pour VMware, obtenez l'instance externe de la passerelle d'entrée que vous configurée après avoir installé Cloud Service Mesh

Si vous avez installé Cloud 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 Cloud 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 Explorez les pages Cloud Service Mesh dans la console Google Cloud pour afficher les métriques caractéristiques.

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

Étape suivante

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

Déployer l'exemple de Bookinfo

Activer l'injection side-car automatique

Géré (TD)

Géré (Istiod)

Dans le cluster

Déployer l'application

Valider le déploiement de l'application

Essayer l'application

Nettoyer

Étape suivante