Listar recursos de "Route"

Este documento é destinado a administradores de malhas que usam as APIs de roteamento de serviço para configurar malhas de serviço.

No modelo da API de roteamento de serviço, os recursos Route são anexados a recursos Mesh ou Gateway. Na configuração, o recurso Mesh ou Gateway faz referência a um ou mais recursos Route.

Se você for proprietário de um recurso Mesh ou Gateway, poderá listar os recursos Route anexados ao Mesh ou Gateway.

Cada recurso Mesh ou Gateway tem uma coleção filha sintética de recursos RouteView. Cada RouteView corresponde a um único Route. Os objetos RouteView são criados com objetos Route.

No diagrama a seguir, o RouteView para Gateway A consiste nos recursos TCPRoute do projeto A. O RouteView para Gateway B inclui os recursos HTTPRoute do Projeto B e os recursos GRPCRoute do Projeto C.

As relações entre os recursos "Rota", "Rota de visualização" e "Gateway".
As relações entre os recursos "Route", "Routeview" e "Gateway".(clique para ampliar)

Esse recurso está limitado ao nível Mesh ou Gateway. Um RouteView para um Gateway ou Mesh lista rotas anexadas a esse Gateway ou Mesh e não todas as rotas anexadas ao escopo associado.

Para listar os recursos RouteView, emita o seguinte comando:

gcloud alpha network-services route-views list \
    --location=global \
    --[mesh | gateway]=[ MESH_NAME | GATEWAY_NAME ]

Para mais informações sobre a rota, emita o seguinte comando: 

gcloud alpha network-services route-views describe --route-view=ROUTEVIEW_FULLNAME

Um fluxo de trabalho comum seria listar o RouteViews para uma malha ou um gateway e, em seguida, descrever cada um para uma visão geral completa das rotas anexadas.

Não é possível criar, atualizar ou excluir recursos RouteView. Eles são criados, atualizados e excluídos quando os recursos Route correspondentes são criados, atualizados e excluídos.

Solução de problemas

Se os comandos route-views não listarem RouteViews para rotas como Listed 0 items. ou não listarem todas as rotas conhecidas:

  • Verifique se a malha ou o gateway usado no route-views list é referenciado nos campos meshes ou gateways da rota, respectivamente, usando:
    • gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
    --location global ROUTE_ID
  • Para clientes com muitos recursos, crie um tíquete de suporte para receber ajuda.
  • Acionar manualmente uma atualização para suas rotas
    • Reimportar a rota
      1. gcloud network-services http-routes export my-route --location=global \
      --destination=export.yaml
      2. gcloud network-services http-routes import my-route --location=global \
      --source=export.yaml
    • Para clientes que usam o cliente NetworkServices gerado, chame a API NetworkServices.Update*Route apropriada.
    • Modifique a descrição para acionar a automação do Terraform.

A seguir