Utiliser Istio en tant que module complémentaire de cluster

Dans cet exemple, vous installez le module complémentaire Istio et la passerelle entrante Istio sur une grappe que vous avez créée avec Kubernetes Engine. Après avoir installé le module complémentaire Istio et la passerelle entrante, vous déployez l'exemple d'application Bookinfo d'Istio et rendez l'application accessible depuis l'extérieur du cluster :

1. Pour plus de commodité, réglez une variable d'environnement nommée CLUSTER_ID à la valeur de l'OCID de la grappe en entrant :

   export CLUSTER_ID=<cluster-ocid>

2. Créez un fichier JSON nommé enableistio-ig.json qui contient les éléments suivants :

   {
     "addonName": "Istio",
     "configurations": [
       {
         "key": "enableIngressGateway",
         "value": "true"
       }
     ]
   }

   Ce fichier de configuration installe le module complémentaire Istio et la passerelle entrante Istio.

3. Installez le module complémentaire Istio et la passerelle entrante Istio sur la grappe en entrant :

   oci ce cluster install-addon --addon-name Istio --cluster-id $CLUSTER_ID --from-json file://./enableistio-ig.json

   Une demande de travail est créée pour installer le module complémentaire Istio.

4. Vérifiez l'installation réussie du module complémentaire Istion et de la passerelle entrante Istio :
   1. Vérifiez que le module complémentaire Istio a été installé avec succès en entrant :

      oci ce cluster list-addons --cluster-id $CLUSTER_ID

      En supposant un déploiement réussi, la sortie affiche le module complémentaire Istio avec un état de cycle de vie ACTIVE. Par exemple, les sorties suivantes affichent le module complémentaire Istio, ainsi que plusieurs modules complémentaires de cluster essentiels :

      {
        "data": [
          {
            "addon-error": null,
            "current-installed-version": "v1.10.1-multiarch-7",
            "lifecycle-state": "ACTIVE",
            "name": "CoreDNS",
            "time-created": "2023-11-06T10:35:26+00:00",
            "version": null
          },
          {
            "addon-error": null,
            "current-installed-version": "v1.19.0",
            "lifecycle-state": "ACTIVE",
            "name": "Istio",
            "time-created": "2023-11-06T11:21:11+00:00",
            "version": null
          },
          {
            "addon-error": null,
            "current-installed-version": "v1.27.2-oke.0.2.20-multiarch-98",
            "lifecycle-state": "ACTIVE",
            "name": "KubeProxy",
            "time-created": "2023-11-06T10:35:26+00:00",
            "version": null
          },
          {
            "addon-error": null,
            "current-installed-version": "v2.0.1",
            "lifecycle-state": "ACTIVE",
            "name": "OciVcnIpNative",
            "time-created": "2023-11-06T10:35:26+00:00",
            "version": null
          }
        ]
      }

   2. Vérifiez que le pod du plan de contrôle Istio (istiod) et le pod istio-ingressgateway s'exécutent tous les deux dans l'espace de noms istio-système en entrant :

      kubectl get pods -n istio-system

      En supposant un déploiement réussi, la sortie affiche les deux pods dont le statut est En cours d'exécution. Par exemple :

      NAME                                   READY   STATUS    RESTARTS   AGE
      istio-ingressgateway-df7d86548-n2vxr   1/1     Running   0          102s
      istiod-65d95bd5f9-vb2qk                1/1     Running   0          101s

   3. Vérifiez que le service istio-ingressgateway a été déployé avec succès en entrant :

      kubectl get svc istio-ingressgateway -n istio-system

      En supposant un déploiement réussi, la sortie affiche le service istio-ingressgateway en tant que service de type LoadBalancer et (si le sous-réseau d'équilibreur de charge de la grappe est public) avec une adresse IP accessible publiquement. Par exemple :

      NAME                   TYPE           CLUSTER-IP     EXTERNAL-IP      PORT(S)                                      AGE
      istio-ingressgateway   LoadBalancer   10.96.31.174   <EXTERNAL-IP>    15021:30089/TCP,80:31662/TCP,443:32217/TCP   2m50s

5. Créez un espace de noms dans lequel déployer l'exemple d'application Bookinfo :
   1. Créez l'espace de noms bookinfo en entrant :

      kubectl create namespace bookinfo

   2. Définissez l'espace de noms bookinfo comme espace de noms par défaut en entrant :

      kubectl config set-context --current --namespace=bookinfo

   3. Vérifiez que bookinfo est l'espace de noms par défaut en entrant :

      kubectl config view --minify | grep namespace

6. Ajoutez l'étiquette istio-injection=enabled à l'espace de noms bookinfo pour installer automatiquement le side-car Envoy dans tous les nouveaux pods d'application déployés dans l'espace de noms :
   1. Ajoutez l'étiquette à l'espace de noms bookinfo en entrant :

      kubectl label namespace bookinfo istio-injection=enabled

   2. Vérifiez que l'espace de noms bookinfo est étiqueté correctement en entrant :

      kubectl get namespace -L istio-injection

7. Déployez l'exemple d'application Bookinfo en entrant :

   kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.19/samples/bookinfo/platform/kube/bookinfo.yaml

   En supposant un déploiement réussi, la sortie affiche plusieurs déploiements et services créés sur le cluster, comme suit :

   service/details created
   serviceaccount/bookinfo-details created
   deployment.apps/details-v1 created
   service/ratings created
   serviceaccount/bookinfo-ratings created
   deployment.apps/ratings-v1 created
   service/reviews created
   serviceaccount/bookinfo-reviews created
   deployment.apps/reviews-v1 created
   deployment.apps/reviews-v2 created
   deployment.apps/reviews-v3 created
   service/productpage created
   serviceaccount/bookinfo-productpage created
   deployment.apps/productpage-v1 created

8. Vérifiez le déploiement réussi de l'exemple d'application Bookinfo :
   1. Vérifiez que les services ont été créés avec succès en entrant :

      kubectl get services

      En supposant un déploiement réussi, la sortie affiche les services créés sur le cluster, comme suit :

      NAME          TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
      details       ClusterIP   10.96.72.219   <none>        9080/TCP   54s
      productpage   ClusterIP   10.96.65.83    <none>        9080/TCP   54s
      ratings       ClusterIP   10.96.101.51   <none>        9080/TCP   54s
      reviews       ClusterIP   10.96.14.9     <none>        9080/TCP   54s

   2. Vérifiez que tous les pods ont le statut Running en entrant :

      kubectl get pods

      En supposant un déploiement réussi, la sortie affiche les pods en cours d'exécution, comme suit :

      NAME                             READY   STATUS    RESTARTS   AGE
      details-v1-5f4d584748-hcm9t      2/2     Running   0          81s
      productpage-v1-564d4686f-48lpw   2/2     Running   0          80s
      ratings-v1-686ccfb5d8-bpl8t      2/2     Running   0          81s
      reviews-v1-86896b7648-6c8d4      2/2     Running   0          81s
      reviews-v2-b7dcd98fb-fsv7c       2/2     Running   0          81s
      reviews-v3-5c5cc7b6d-qgrv2       2/2     Running   0          81s

      La sortie montre que chaque pod d'application comporte deux conteneurs. Pour chaque pod, un conteneur est le conteneur d'application, et l'autre conteneur est le side-car Envoy injecté par Istio.

   3. Vérifiez que le pod ratings comporte deux conteneurs (l'un d'entre eux est le conteneur d'application et l'autre est le side-car Envoy injecté par Istio). Par exemple, en entrant :

      kubectl get pods ratings-v1-686ccfb5d8-bpl8t -o jsonpath='{.spec.containers[*].name}'

      La sortie montre deux conteneurs, le conteneur d'application (ratings) et le conteneur de side-car Envoy injecté par Istio (istio-proxy) :

      ratings istio-proxy

   4. Vérifiez que l'application est en cours d'exécution en envoyant une commande curl à partir d'un pod :

      kubectl exec "$(kubectl get pod -l app=ratings -o jsonpath='{.items[0].metadata.name}')" -c ratings -- curl -sS productpage:9080/productpage | grep -o "<title>.*</title>"
      <title>Simple Bookstore App</title>

      Notez que l'exemple d'application Bookinfo n'est pas encore accessible depuis l'extérieur de la grappe, même après l'activation de la passerelle entrante. Notez également que l'accessibilité de la passerelle entrante Istio dépend du type de sous-réseau de l'équilibreur de charge (public ou privé) spécifié pour la grappe.

9. Rendre l'exemple d'application Bookinfo accessible depuis l'extérieur du cluster :

   1. Mappez le trafic entrant de l'exemple de déploiement à la passerelle entrante Istio en entrant :

      kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.19/samples/bookinfo/networking/bookinfo-gateway.yaml

      La sortie montre que la passerelle Kubernetes et les ressources VirtualService ont été créées :

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

10. Vérifiez que l'exemple d'application Bookinfo est accessible et qu'elle utilise la passerelle entrante Istio :
    1. Définissez les variables d'environnement pour l'hôte entrant et le port entrant en entrant :

       export INGRESS_NAME=istio-ingressgateway

       export INGRESS_NS=istio-system

       export INGRESS_HOST=$(kubectl -n "$INGRESS_NS" get service "$INGRESS_NAME" -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

       export INGRESS_PORT=$(kubectl -n "$INGRESS_NS" get service "$INGRESS_NAME" -o jsonpath='{.spec.ports[?(@.name=="http2")].port}')

    2. Confirmez que l'exemple d'application Bookinfo est accessible et utilisez la passerelle entrante Istio en entrant :

       curl -s "http://${INGRESS_HOST}:${INGRESS_PORT}/productpage" | grep -o "<title>.*</title>"

       En supposant un déploiement réussi, la sortie affiche les services créés sur le cluster, comme suit :

       <title>Simple Bookstore App</title>

    3. Consultez la page Web Bookinfo dans un navigateur en ouvrant l'URL suivante :

       http://${INGRESS_HOST}:${INGRESS_PORT}/productpage

    4. Dans le navigateur, actualisez la page Web Bookinfo plusieurs fois pour voir différentes versions des critiques affichées sur la page.
11. (Facultatif) Après avoir terminé l'exemple, vous pouvez maintenant supprimer les ressources que vous avez créées :
    1. Supprimez l'exemple d'application Bookinfo en entrant :

       kubectl delete -f https://raw.githubusercontent.com/istio/istio/release-1.19/samples/bookinfo/platform/kube/bookinfo.yaml

    2. Désactivez (et éventuellement supprimez) le module complémentaire Istio à l'aide de la commande oci ce cluster disable-addon, en entrant :

       oci ce cluster disable-addon --addon-name Istio --cluster-id $CLUSTER_ID --is-remove-existing-add-on <true|false>

       où --is-remove-existing-add-on <true|false> spécifie soit de supprimer complètement le module complémentaire Istio (lorsqu'il est réglé à true), soit de ne pas supprimer le module complémentaire, mais simplement de le désactiver et de ne pas l'utiliser (lorsqu'il est réglé à false). Si vous désactivez le module complémentaire, Oracle ne le met plus à jour automatiquement lorsque de nouvelles versions deviennent disponibles.

       Par exemple :

       oci ce cluster disable-addon --addon-name Istio --cluster-id $CLUSTER_ID --is-remove-existing-add-on true

       Une demande de travail est créée pour désactiver (et éventuellement supprimer) le module complémentaire Istio.

    3. Supprimez Istio CustomResourceDefinitions (CRD), qui ne sont pas supprimés par défaut, en entrant :

       kubectl delete crd $(kubectl get crd -A | grep "istio.io" | awk '{print $1}')

    4. Supprimez les ressources de maillage Istio (telles que la passerelle Kubernetes et les ressources VirtualService), qui ne sont pas gérées par le module complémentaire Istio, en entrant :

       kubectl delete -f https://raw.githubusercontent.com/istio/istio/release-1.19/samples/bookinfo/networking/bookinfo-gateway.yaml