Trabalhando com o Istio como um Complemento do Cluster

Neste exemplo, você instala o add-on Istio e o gateway de entrada Istio em um cluster criado com o Kubernetes Engine. Depois de instalar o add-on e o gateway de entrada do Istio, você implanta o aplicativo Bookinfo de amostra do Istio e torna o aplicativo acessível de fora do cluster:

1. Por conveniência, defina uma variável de ambiente chamada CLUSTER_ID como o valor do OCID do cluster digitando:

   export CLUSTER_ID=<cluster-ocid>

2. Crie um arquivo JSON chamado enableistio-ig.json que contenha o seguinte:

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

   Este arquivo de configuração instala o add-on do Istio e o gateway de entrada do Istio.

3. Instale o add-on do Istio e o gateway de entrada do Istio no cluster digitando:

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

   Uma solicitação de serviço é criada para instalar o complemento Istio.

4. Verifique a instalação bem-sucedida do complemento Istion e do gateway de entrada Istio:
   1. Confirme se a extensão Istio foi instalada com sucesso inserindo:

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

      Pressupondo uma implantação bem-sucedida, a saída mostra o complemento Istio com um estado de ciclo de vida ACTIVE. Por exemplo, as seguintes saídas mostram o complemento Istio, juntamente com vários complementos essenciais de cluster:

      {
        "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. Confirme se o pod do plano de controle Istio (istiod) e o pod istio-ingressgateway estão sendo executados no namespace istio-system digitando:

      kubectl get pods -n istio-system

      Supondo uma implantação bem-sucedida, a saída mostra os dois pods com um status de Em Execução. Por exemplo:

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

   3. Confirme se o serviço istio-ingressgateway foi implantado com sucesso digitando:

      kubectl get svc istio-ingressgateway -n istio-system

      Pressupondo uma implantação bem-sucedida, a saída mostra o serviço istio-ingressgateway como um serviço do tipo LoadBalancer e (se a sub-rede do balanceador de carga do cluster for pública) com um endereço IP acessível publicamente. Por exemplo:

      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. Crie um novo namespace no qual implantar o aplicativo de amostra Bookinfo:
   1. Crie o namespace bookinfo digitando:

      kubectl create namespace bookinfo

   2. Torne o namespace bookinfo o namespace padrão digitando:

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

   3. Confirme se bookinfo é o namespace padrão digitando:

      kubectl config view --minify | grep namespace

6. Adicione o label istio-injection=enabled ao namespace bookinfo para instalar automaticamente o sidecar do Envoy em quaisquer novos pods de aplicativo implantados no namespace:
   1. Adicione o label ao namespace de informações do livro digitando:

      kubectl label namespace bookinfo istio-injection=enabled

   2. Confirme se o namespace bookinfo está rotulado corretamente digitando:

      kubectl get namespace -L istio-injection

7. Implante o aplicativo de amostra Bookinfo digitando:

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

   Supondo uma implantação bem-sucedida, a saída mostra várias implantações e serviços criados no cluster, da seguinte forma:

   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. Verifique a implantação bem-sucedida do aplicativo de amostra Bookinfo:
   1. Confirme se os serviços foram criados com sucesso informando:

      kubectl get services

      Supondo uma implantação bem-sucedida, a saída mostra os serviços criados no cluster, semelhante ao seguinte:

      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. Confirme se todos os pods têm o status Running digitando:

      kubectl get pods

      Supondo uma implantação bem-sucedida, a saída mostra os pods que estão em execução, semelhante ao seguinte:

      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

      A saída mostra que cada pod de aplicativo tem dois contêineres. Para cada pod, um contêiner é o contêiner de aplicativos e o outro contêiner é o sidecar Envoy injetado pelo Istio.

   3. Confirme se o pod ratings tem dois contêineres (um dos quais é o contêiner de aplicativos e o outro é o sidecar do Envoy injetado pelo Istio). Por exemplo, informando:

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

      A saída mostra dois contêineres, o contêiner de aplicação (classificações) e o contêiner sidecar Envoy injetado pelo Istio (istio-proxy):

      ratings istio-proxy

   4. Confirme se o aplicativo está em execução enviando um comando curl de um 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>

      Observe que o aplicativo de amostra Bookinfo ainda não está acessível de fora do cluster, mesmo depois de ativar o gateway de entrada. Observe também que a acessibilidade do gateway de entrada do Istio depende do tipo de sub-rede do balanceador de carga (pública ou privada) especificada para o cluster.

9. Torne o aplicativo de amostra Bookinfo acessível de fora do cluster:

   1. Mapeie a entrada da implantação de amostra para o gateway de entrada do Istio digitando:

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

      A saída mostra que o Gateway do Kubernetes e os recursos VirtualService foram criados:

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

10. Verifique se o aplicativo de amostra Bookinfo está acessível e usando o gateway de entrada Istio:
    1. Defina variáveis de ambiente para o host de entrada e a porta de entrada digitando:

       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. Confirme se o aplicativo de amostra Bookinfo está acessível e usando o gateway de entrada Istio digitando:

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

       Supondo uma implantação bem-sucedida, a saída mostra os serviços criados no cluster, semelhante ao seguinte:

       <title>Simple Bookstore App</title>

    3. Visualize a página web Bookinfo em um navegador abrindo o seguinte URL:

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

    4. No navegador, atualize a página do Bookinfo várias vezes para ver diferentes versões de revisões mostradas na página.
11. (Opcional) Depois de concluir o exemplo, agora você pode excluir os recursos criados:
    1. Exclua o aplicativo de amostra Bookinfo digitando:

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

    2. Desative (e opcionalmente remova) o complemento do Istio usando o comando oci ce cluster disable-addon, digitando:

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

       em que --is-remove-existing-add-on <true|false> especifica ou remover completamente o complemento Istio (quando definido como true), ou não remover o complemento, mas simplesmente desativá-lo e não usá-lo (quando definido como false). Se desativar a extensão, a Oracle não atualizará mais a versão da extensão automaticamente quando novas versões estiverem disponíveis.

       Por exemplo:

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

       Uma solicitação de serviço é criada para desativar (e, opcionalmente, remover) o complemento Istio.

    3. Remova o Istio CustomResourceDefinitions (CRDs), que não são excluídos por padrão, digitando:

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

    4. Remova os recursos de malha do Istio (como o Kubernetes Gateway e os recursos VirtualService), que não são gerenciados pelo complemento do Istio, digitando:

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