Alibaba Cloud Service Mesh:Using traffic routing with an ASM gateway

Pré-requisitos

• O cluster foi adicionado à instância ASM.

• A injeção automática de sidecar está ativada para o namespace. Para mais informações, consulte Ativar injeção automática.

• Um gateway de entrada está implantado. Para mais informações, consulte Criar um gateway de entrada.

• Uma aplicação está implantada no cluster associado à instância ASM. Para mais informações, consulte Implantar uma aplicação em um cluster associado ao ASM.

• Obtenha o endereço do gateway ASM. Para mais informações, consulte Obter o endereço de um gateway de entrada.

Visão geral

Este tópico usa o serviço reviews como exemplo para demonstrar a configuração de políticas de tráfego, como balanceamento de carga e pools de conexões, pela GUI. Após criar uma política de tráfego, o sistema gera automaticamente um arquivo YAML correspondente à regra de destino. O tópico também aborda a criação de regras de roteamento para caminhos no serviço Bookinfo, como /productpage e /login. Isso permite acessar o serviço Bookinfo por caminhos como /productpage.

Criar um domínio

1. Faça login no console ASM. No painel de navegação à esquerda, escolha Service Mesh > Mesh Management.

2. Na página Mesh Management, clique em nome da instância ASM. No painel de navegação à esquerda, escolha ASM Gateways > Ingress Gateway.

3. Na página Ingress Gateway, clique em nome do gateway desejado. No painel de navegação à esquerda da página de visão geral do gateway, clique em Domain/Certificate.

4. Na página Add domain, configure os parâmetros abaixo e clique em Create.

   Parâmetro	Exemplo
   Domain	*
   Protocol	HTTP
   Namespaces	default
   Port Name	http
   Port	80

Importar um serviço upstream

Importe serviços upstream para o gateway ASM.

1. Na página Ingress Gateway, clique em nome do gateway desejado. No painel de navegação à esquerda da página de visão geral do gateway, clique em Upstream Service.

2. Na página Upstream Service, clique em Import service. Na página Import service, selecione um Namespaces, marque os serviços reviews e productpage, clique em ícone e clique em Confirm.

Criar uma política de tráfego

1. Gerencie as versões do serviço.

   Neste exemplo, as instâncias do serviço reviews são agrupadas em três versões: v1, v2 e v3.

   1. Na página Upstream Service, localize o serviço reviews e clique em versions na coluna Operator.

   2. Na página versions, clique em Add Service Version (Subset), defina Name como v1, clique em Add Label, defina Key como version e defina Value como v1.

   3. Clique em Add Service Version (Subset), defina Name como v2, clique em Add Label, defina Key como version e defina Value como v2.

   4. Clique novamente em Add Service Version (Subset), defina Name como v3, clique em Add Label, defina Key como version e defina Value como v3. Em seguida, clique em Create.

2. Crie uma política de tráfego.

   1. Na página Upstream Service, localize o serviço reviews e clique em traffic policy na coluna Operator.

   2. Na página traffic policy, clique em Add Policy, selecione Subset Level e escolha a versão v3. Ative a chave Load Balancing, selecione Simple, defina Mode como Random e clique em Submit.

3. (Opcional) Visualize o arquivo YAML da regra de destino gerado durante a criação da política de tráfego.

   Na página Upstream Service, localize o serviço reviews e clique em View YAML na coluna Operator. Na caixa de diálogo Preview, visualize o arquivo YAML. Após confirmar o conteúdo, clique em Confirm.

   Nota

   Alternativamente, no painel de navegação à esquerda da página de detalhes da malha, escolha Traffic Management Center > DestinationRule. Na página DestinationRule, localize a regra de destino desejada e clique em View YAML na coluna Operator. Na caixa de diálogo Edit, visualize o arquivo YAML gerado para a regra de destino.

   YAML

   apiVersion: networking.istio.io/v1beta1
   kind: DestinationRule
   metadata:
     name: reviews
     namespace: default
     labels:
       provider: asm
   spec:
     host: reviews
     subsets:
       - name: v1
         labels:
           version: v1
       - name: v2
         labels:
           version: v2
       - name: v3
         labels:
           version: v3
         trafficPolicy:
           loadBalancer:
             simple: RANDOM

Criar regras de roteamento

1. Crie as regras de roteamento.

   1. Crie uma regra de roteamento para /productpage.

      1. No painel de navegação à esquerda da página de visão geral do gateway, clique em Route management e clique em Create.

      2. No assistente set route detail, configure os parâmetros e clique em Next.

         Parâmetro	Exemplo
         route type	Neste exemplo, selecione http.
         Namespaces	Neste exemplo, selecione default.
         route name	Neste exemplo, insira productpage-route.
         description	Neste exemplo, insira productpage route.
         priority	Neste exemplo, insira 3. Nota As regras de roteamento são priorizadas por número. Um número menor indica maior prioridade. Se uma URI de solicitação corresponder a várias regras de roteamento, o ASM aplica aquela com a maior prioridade.
         Matching rules	Configure a correspondência de URL. Somente solicitações de URLs que atendem aos requisitos podem ser roteadas para o serviço de destino. Ative a chave Matching request URI. Defina Method como Exact e Content como /productpage. Nota Você também pode clicar em Add Header Matching Rule para configurar a correspondência de cabeçalho.

      3. No assistente set route destination, configure os parâmetros e clique em Next.

         Parâmetro	Exemplo
         select upstream service	Selecione o serviço ao qual a regra de roteamento se aplica. Neste exemplo, selecione productpage.
         Port	Opcional. A porta exposta pelo serviço upstream. Necessário apenas se o serviço expuser mais de uma porta. Neste exemplo, deixe este parâmetro vazio.
         Subset	Especifica a versão do serviço (subset) à qual a regra de roteamento se aplica. Deixe este campo vazio neste exemplo.
         Weight	Especifica o peso do tráfego para o serviço de destino. Deixe este campo vazio neste exemplo.

      4. No assistente advanced config, ative a chave Fault Injection. Em seguida, ative a chave Request Latency, defina Latency como 4s e Injection Percentage como 100, e clique em Create.

   2. Crie uma regra de roteamento para /static.

      1. Na página Route management, clique em Create.

      2. No assistente set route detail, configure os parâmetros e clique em Next.

         Parâmetro	Exemplo
         route type	Neste exemplo, selecione http.
         Namespaces	Neste exemplo, selecione default.
         route name	Neste exemplo, insira static.
         description	Neste exemplo, insira static resource.
         priority	Neste exemplo, insira 0.
         Matching rules	Configure a correspondência de URL. Somente solicitações de URLs que atendem aos requisitos podem ser roteadas para o serviço de destino. Ative a chave Matching request URI. Defina Method como Prefix e Content como /static.

      3. Os passos para criar a rota /static são idênticos aos da rota /productpage. Para detalhes, consulte Criar a rota productpage.

   3. Crie uma regra de roteamento para /login.

      1. Na página Route management, clique em Create.

      2. No assistente set route detail, configure os parâmetros e clique em Next.

         Parâmetro	Exemplo
         route type	Neste exemplo, selecione http.
         Namespaces	Neste exemplo, selecione default.
         route name	Neste exemplo, insira login.
         description	Neste exemplo, insira login request route.
         priority	Neste exemplo, insira 0.
         Matching rules	Configure a correspondência de URL. Somente solicitações de URLs que atendem aos requisitos podem ser roteadas para o serviço de destino. Ative a chave Matching request URI. Defina Method como Prefix e Content como /login.

      3. Os passos subsequentes para criar a rota /login seguem o mesmo procedimento da rota /productpage. Para os passos detalhados, consulte Criar a rota productpage.

   4. Crie uma regra de roteamento para /logout.

      1. Na página Route management, clique em Create.

      2. No assistente set route detail, configure os parâmetros e clique em Next.

         Parâmetro	Exemplo
         route type	Neste exemplo, selecione http.
         Namespaces	Neste exemplo, selecione default.
         route name	Neste exemplo, insira logout.
         description	Neste exemplo, insira logout route.
         priority	Neste exemplo, insira 0.
         Matching rules	Configure a correspondência de URL. Somente solicitações de URLs que atendem aos requisitos podem ser roteadas para o serviço de destino. Ative a chave Matching request URI. Defina Method como Prefix e Content como /logout.

      3. Os passos subsequentes para criar a rota /logout seguem o mesmo procedimento da rota /productpage. Para os passos detalhados, consulte Criar a rota productpage.

   5. Crie uma regra de roteamento para /api/v1/products.

      1. Na página Route management, clique em Create.

      2. No assistente set route detail, configure os parâmetros e clique em Next.

         Parâmetro	Descrição
         route type	Neste exemplo, selecione http.
         Namespaces	Neste exemplo, selecione default.
         route name	Neste exemplo, insira products-route.
         description	Neste exemplo, insira product information.
         priority	Neste exemplo, insira 0.
         Matching rules	Configure a correspondência de URL. Somente solicitações de URLs que atendem aos requisitos podem ser roteadas para o serviço de destino. Ative a chave Matching request URI. Defina Method como Prefix e Content como /api/v1/products.

      3. Os passos subsequentes para criar a rota /api/v1/products seguem o mesmo procedimento da rota /productpage. Para detalhes, consulte Criar a rota productpage.

2. Verifique as regras de roteamento.

   1. Na barra de endereços do navegador, insira http://{IP address of the ingress gateway}/productpage.

      A página de produto da aplicação de exemplo Bookinfo será exibida. Ela inclui um resumo do livro The Comedy of Errors, Book Details (como gênero, contagem de páginas, editora e idioma) e Book Reviews (incluindo classificações e comentários). Isso confirma que a regra de roteamento funciona corretamente.

   2. No canto superior direito da página do Bookinfo, clique em Sign in.

   3. Na página Please sign in, insira qualquer nome de usuário e senha e clique em Sign in.

      O login no Bookinfo será realizado com sucesso. Após o login, a página de produto da aplicação Bookinfo será exibida. O nome de usuário default aparecerá no canto superior direito, e os detalhes e avaliações do livro serão mostrados corretamente. Isso indica que o serviço está acessível.

      Para verificar outras rotas, acesse o serviço Bookinfo utilizando caminhos como /logout, /static e /api/v1/products.

   4. Abra as ferramentas de desenvolvedor do navegador e alterne para a aba de rede.

   5. Atualize a página.

      Um atraso de aproximadamente 4 segundos será observado. No painel Network das ferramentas de desenvolvedor do navegador, a solicitação productpage leva cerca de 4,21 segundos, enquanto outros recursos estáticos, como CSS, JS e arquivos de fonte, levam 0 ms. Isso confirma que a política de injeção de falhas funciona corretamente.

3. (Opcional) Visualize o arquivo YAML do serviço virtual gerado após a criação das regras de roteamento.

   1. Na página de detalhes da instância ASM, escolha Traffic Management Center > VirtualService no painel de navegação à esquerda.

   2. Na página Virtual Service, localize o serviço virtual desejado e clique em View YAML na coluna Operator.

   3. Na caixa de diálogo Edit, visualize o arquivo YAML gerado para o serviço virtual. Após confirmar o conteúdo, clique em OK.

Operações relacionadas