Configurar uma malha de serviço de vários clusters

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Este guia mostra como adicionar um novo cluster do GKE a uma malha de serviço atual.

Antes de começar

Antes de adicionar um cluster, conclua as instruções em Preparar para implantar com a API GKE Gateway, incluindo Ativar serviços de vários clusters.

Criar um novo cluster do GKE

1. Crie um novo cluster usando o seguinte comando:

   gcloud container clusters create gke-2 \
     --zone=us-west1-a \
     --enable-ip-alias \
     --workload-pool=PROJECT_ID.svc.id.goog \
     --scopes=https://www.googleapis.com/auth/cloud-platform \
     --release-channel regular \
     --project=PROJECT_ID
   

2. Mude para o cluster que você acabou de criar emitindo o comando a seguir:

   gcloud container clusters get-credentials gke-2 --zone us-west1-a
   

3. Renomeie o contexto do cluster:

   kubectl config rename-context gke_PROJECT_ID_us-west1-a_gke-2 gke-2
   

Registrar o cluster em uma frota

1. Após a criação do cluster, registre-o na sua frota:

   gcloud alpha container hub memberships register gke-2 \
     --gke-cluster us-west1-a/gke-2 \
     --enable-workload-identity \
     --project=PROJECT_ID
   

2. Verifique se os clusters estão registrados na frota:

   gcloud alpha container hub memberships list --project=PROJECT_ID
   

   O Fleet inclui o cluster que você acabou de criar e o cluster criado anteriormente:

   NAME          EXTERNAL_ID
   gke-1  657e835d-3b6b-4bc5-9283-99d2da8c2e1b
   gke-2  f3727836-9cb0-4ffa-b0c8-d51001742f19
   

Implantar o injetor do arquivo secundário do Envoy no novo cluster do GKE

Siga as instruções para implantar o injetor do arquivo secundário do Envoy e implantar o injetor no cluster gke-2.

Expandir a malha de serviço para o novo cluster do GKE

O guia Implantar uma malha de serviço secundário do Envoy mostra como configurar uma malha de serviço no cluster gke-1, em que o serviço store é executado. Esta seção mostra como expandir a malha de serviço para incluir um serviço payments em execução no cluster gke-2. Como um recurso Mesh já existe no cluster de configuração, não é necessário criar um recurso Mesh no novo cluster.

Implantar o serviço payments

1. No arquivo payments.yaml, salve o seguinte manifesto:

   kind: Namespace
   apiVersion: v1
   metadata:
     name: payments
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: payments
     namespace: payments
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: payments
         version: v1
     template:
       metadata:
         labels:
           app: payments
           version: v1
       spec:
         containers:
         - name: whereami
           image: us-docker.pkg.dev/google-samples/containers/gke/whereami:v1.2.20
           ports:
           - containerPort: 8080
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: payments
     namespace: payments
   spec:
     selector:
       app: payments
     ports:
     - port: 8080
       targetPort: 8080
   

2. Aplique o manifesto ao cluster gke-2:

   kubectl apply --context gke-2 -f payments.yaml
   

Exportar o serviço payments

Todos os recursos da API Gateway são armazenados centralmente no cluster de configuração gke-1. Os serviços em outros clusters na frota precisam ser exportados para que os recursos da API Gateway no cluster gke-1 possam referenciá-los quando você configurar o comportamento de rede da malha de serviço.

Para uma explicação detalhada de como ServiceExport e ServiceImport funcionam, leia Serviços de vários clusters.

1. Crie o namespace payments no cluster gke-1. O serviço payments no cluster gke-1 é exportado para todos os clusters na frota que estão no mesmo namespace.

   kubectl create namespace payments --context gke-1
   

2. No arquivo export-payments.yaml, salve o seguinte manifesto:

   kind: ServiceExport
   apiVersion: net.gke.io/v1
   metadata:
     name: payments
     namespace: payments
   

3. Aplique o manifesto ServiceExport no cluster gke-2:

   kubectl apply --context gke-2 -f export-payments.yaml
   

4. Após alguns minutos, execute o seguinte comando para verificar se o serviceImports complementar foi criado pelo controlador de serviços de vários clusters em gke-1:

   kubectl get serviceimports --context gke-1 --namespace payments
   

   A saída será semelhante a esta:

   NAME           TYPE           IP                  AGE
   payments       ClusterSetIP   ["10.112.31.15"]    6m54s
   

Configurar um recurso HTTPRoute para o serviço payments

1. No arquivo payments-route.yaml, salve o seguinte manifesto HTTPRoute:

   apiVersion: gateway.networking.k8s.io/v1alpha2
   kind: HTTPRoute
   metadata:
     name: payments-route
     namespace: payments
   spec:
     parentRefs:
     - name: td-mesh
       namespace: default
       group: net.gke.io
       kind: TDMesh
     hostnames:
     - "example.com"
     rules:
     - matches:
       - path:
           type: PathPrefix
           value: /payments
       backendRefs:
       - group: net.gke.io
         kind: ServiceImport
         namespace: payments
         name: payments
         port: 8080
   

2. Aplique o manifesto do trajeto a gke-1:

   kubectl apply --context gke-1 -f payments-route.yaml
   

Validar a implantação

Inspecione o status e os eventos de Mesh para verificar se Mesh e HTTPRoute foram implantados corretamente.

1. Execute este comando:

   kubectl describe tdmesh td-mesh -–context gke-1
   

   A saída será semelhante a:

   ...
   Status:
     Conditions:
       Last Transition Time:  2022-04-14T22:49:56Z
       Message:
       Reason:                MeshReady
       Status:                True
       Type:                  Ready
       Last Transition Time:  2022-04-14T22:27:17Z
       Message:
       Reason:                Scheduled
       Status:                True
       Type:                  Scheduled
   Events:
     Type    Reason  Age                From                Message
     ----    ------  ----               ----                -------
     Normal  ADD     23m                mc-mesh-controller  Processing mesh default/td-mesh
     Normal  UPDATE  23m                mc-mesh-controller  Processing mesh default/td-mesh
     Normal  SYNC    23m                mc-mesh-controller  Processing mesh default/td-mesh
     Normal  SYNC    71s                mc-mesh-controller  SYNC on default/td-mesh was a success
   

2. Para verificar a implantação, implante um pod cliente em um dos clusters. No arquivo client.yaml, salve o seguinte:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     labels:
       run: client
     name: client
     namespace: default
   spec:
     replicas: 1
     selector:
       matchLabels:
         run: client
     template:
       metadata:
         labels:
           run: client
       spec:
         containers:
         - name: client
           image: curlimages/curl
           command:
           - sh
           - -c
           - while true; do sleep 1; done
   

3. Aplique o manifesto:

   kubectl apply -f client.yaml --context $CLUSTER
   

   O injetor secundário em execução no cluster injeta automaticamente um contêiner do Envoy no pod cliente.

4. Para verificar se o contêiner do Envoy foi injetado, execute o seguinte comando:

   kubectl describe pods -l run=client --context $CLUSTER
   

   O resultado será assim:

   ...
   Init Containers:
     # Istio-init sets up traffic interception for the Pod.
     istio-init:
   ...
     # td-bootstrap-writer generates the Envoy bootstrap file for the Envoy container
     td-bootstrap-writer:
   ...
   Containers:
   # client is the client container that runs application code.
     client:
   ...
   # Envoy is the container that runs the injected Envoy proxy.
     envoy:
   ...
   

5. Depois que o mesh e o pod cliente forem provisionados, envie uma solicitação do pod cliente para o serviço store:

   # Get the name of the client Pod.
   CLIENT_POD=$(kubectl get pod --context $CLUSTER -l run=client -o=jsonpath='{.items[0].metadata.name}')
   
   # The VIP where the following request will be sent. Because requests from the
   # Busybox container are redirected to the Envoy proxy, the IP address can
   # be any other address, such as 10.0.0.2 or 192.168.0.1.
   VIP='10.0.0.1'
   
   # Command to send a request to store.
   TEST_CMD="curl -v -H 'Host: example.com' $VIP/store"
   
   # Execute the test command in the client container.
   kubectl exec -it $CLIENT_POD -c client --context $CLUSTER -- /bin/sh -c "$TEST_CMD"
   

   A resposta mostrará que um dos pods store em gke-1 atende à solicitação:

   {
     "cluster_name": "gke-1",
     "zone": "us-central1-a",
     "host_header": "example.com",
   ...
   }
   

6. Envie uma solicitação para o serviço payments:

   # Command to send a request to payments.
   TEST_CMD="curl -v -H 'host: example.com' $VIP/payments"
   
   # Execute the test command in the client container.
   kubectl exec -it $CLIENT_POD -c client -- /bin/sh -c "$TEST_CMD"
   

   A resposta mostrará que um dos pods payments no gke-2 atende à solicitação:

   {
     "cluster_name": "gke-2",
     "zone": "us-west1-a",
     "host_header": "example.com",
   ...
   }
   

A seguir

• Saiba como resolver problemas com sua implantação.