Utilizzo di Istio come componente aggiuntivo cluster

In questo esempio, è possibile installare il componente aggiuntivo Istio e il gateway di entrata Istio in un cluster creato con Kubernetes Engine. Dopo aver installato l'add-on Istio e il gateway di ingresso, si distribuisce l'applicazione Bookinfo di esempio di Istio e si rende l'applicazione accessibile dall'esterno del cluster:

1. Per comodità, impostare una variabile di ambiente denominata CLUSTER_ID sul valore dell'OCID del cluster immettendo:

   export CLUSTER_ID=<cluster-ocid>

2. Creare un file JSON denominato enableistio-ig.json contenente gli elementi riportati di seguito.

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

   Questo file di configurazione installa l'add-on Istio e il gateway di ingresso Istio.

3. Installare l'add-on Istio e il gateway di ingresso Istio sul cluster immettendo:

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

   Viene creata una richiesta di lavoro per installare il componente aggiuntivo Istio.

4. Verificare la corretta installazione del componente aggiuntivo Istion e del gateway di ingresso Istio:
   1. Verificare che il componente aggiuntivo Istio sia stato installato correttamente inserendo:

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

      Supponendo una distribuzione riuscita, l'output mostra l'add-on Istio con lo stato del ciclo di vita ACTIVE. Ad esempio, i seguenti output mostrano l'add-on Istio, insieme a una serie di componenti aggiuntivi cluster essenziali:

      {
        "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. Verificare che il pod del piano di controllo Istio (istiod) e il pod istio-ingressgateway siano entrambi in esecuzione nello spazio dei nomi istio-system immettendo:

      kubectl get pods -n istio-system

      Se si presuppone che la distribuzione sia riuscita, l'output mostra entrambi i pod con stato In esecuzione. Ad esempio:

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

   3. Verificare che il servizio istio-ingressgateway sia stato distribuito correttamente immettendo:

      kubectl get svc istio-ingressgateway -n istio-system

      Supponendo che la distribuzione sia riuscita, l'output mostra il servizio istio-ingressgateway come servizio di tipo LoadBalancer e (se la subnet del load balancer del cluster è pubblica) con un indirizzo IP accessibile pubblicamente. Ad esempio:

      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. Creare un nuovo spazio di nomi in cui distribuire l'applicazione di esempio Bookinfo:
   1. Creare lo spazio di nomi bookinfo immettendo:

      kubectl create namespace bookinfo

   2. Per impostare lo spazio di nomi bookinfo come spazio di nomi predefinito, immettere:

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

   3. Verificare che bookinfo sia lo spazio di nomi predefinito immettendo:

      kubectl config view --minify | grep namespace

6. Aggiungere l'etichetta istio-injection=enabled allo spazio di nomi bookinfo per installare automaticamente il sidecar Envoy in qualsiasi nuovo pod applicazione distribuito nello spazio di nomi:
   1. Aggiungere l'etichetta allo spazio di nomi bookinfo immettendo:

      kubectl label namespace bookinfo istio-injection=enabled

   2. Verificare che lo spazio di nomi bookinfo sia etichettato correttamente immettendo:

      kubectl get namespace -L istio-injection

7. Per distribuire l'applicazione di esempio Bookinfo, immettere:

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

   Supponendo che la distribuzione sia riuscita, l'output mostra diverse distribuzioni e servizi creati nel cluster, come indicato di seguito.

   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. Verificare che la distribuzione dell'applicazione di esempio Bookinfo sia riuscita:
   1. Confermare che i servizi sono stati creati correttamente immettendo:

      kubectl get services

      Supponendo che la distribuzione sia riuscita, l'output mostra i servizi creati nel cluster, in modo simile al seguente:

      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. Verificare che tutti i pod abbiano lo stato In esecuzione immettendo:

      kubectl get pods

      Supponendo una distribuzione riuscita, l'output mostra i pod in esecuzione, in modo simile al seguente:

      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

      L'output mostra che ogni pod dell'applicazione dispone di due contenitori. Per ogni pod, un contenitore è il contenitore dell'applicazione e l'altro è il sidecar Envoy iniettato da Istio.

   3. Verificare che il pod ratings disponga di due contenitori (uno dei quali è il contenitore dell'applicazione e l'altro è il sidecar Envoy iniettato da Istio). Ad esempio, immettendo:

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

      L'output mostra due contenitori, il contenitore applicativo (rapporti) e il contenitore sidecar Envoy iniettato da Istio (istio-proxy):

      ratings istio-proxy

   4. Verificare che l'applicazione sia in esecuzione inviando un comando curl da 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>

      Tenere presente che l'applicazione di esempio Bookinfo non è ancora accessibile dall'esterno del cluster, anche dopo aver abilitato il gateway in entrata. Si noti inoltre che l'accessibilità del gateway di entrata Istio dipende dal tipo di subnet del load balancer (pubblica o privata) specificata per il cluster.

9. Rendere l'applicazione di esempio Bookinfo accessibile dall'esterno del cluster:

   1. Mappare l'ingresso della distribuzione di esempio al gateway di entrata Istio immettendo:

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

      L'output mostra che il gateway Kubernetes e le risorse VirtualService sono stati creati:

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

10. Verificare che l'applicazione di esempio Bookinfo sia accessibile e che utilizzi il gateway di entrata Istio:
    1. Impostare le variabili di ambiente per l'host in entrata e la porta in entrata immettendo:

       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. Verificare che l'applicazione di esempio Bookinfo sia accessibile e che utilizzi il gateway di entrata Istio immettendo:

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

       Supponendo che la distribuzione sia riuscita, l'output mostra i servizi creati nel cluster, in modo simile al seguente:

       <title>Simple Bookstore App</title>

    3. Visualizzare la pagina Web Bookinfo in un browser aprendo il seguente URL:

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

    4. Nel browser, aggiornare più volte la pagina Web Bookinfo per visualizzare diverse versioni delle recensioni visualizzate nella pagina.
11. (Facoltativo) Dopo aver completato l'esempio, è ora possibile eliminare le risorse create:
    1. Eliminare l'applicazione di esempio Bookinfo immettendo:

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

    2. Disabilitare (e facoltativamente rimuovere) il componente aggiuntivo Istio utilizzando il comando oci ce cluster disable-addon, immettendo:

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

       dove --is-remove-existing-add-on <true|false> specifica di rimuovere completamente l'add-on Istio (se impostato su true) o di non rimuovere l'add-on, ma semplicemente di disattivarlo e di non utilizzarlo (se impostato su false). Se disabiliti il componente aggiuntivo, Oracle non lo aggiorna più automaticamente quando diventano disponibili nuove versioni.

       Ad esempio:

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

       Viene creata una richiesta di lavoro per disabilitare (e facoltativamente rimuovere) il componente aggiuntivo Istio.

    3. Rimuovere l'Istio CustomResourceDefinitions (CRD), non eliminati per impostazione predefinita, immettendo:

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

    4. Rimuovere le risorse mesh Istio (ad esempio il gateway Kubernetes e le risorse VirtualService), non gestite dall'add-on Istio, immettendo:

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