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 de API de roteamento de serviço, os recursos Route são anexados a 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 RouteView do Google Cloud. Cada RouteView corresponde a um único Route. Os objetos RouteView são criados com os objetos Route.

No diagrama a seguir, a RouteView para a Gateway A consiste no TCPRoute recursos do Projeto A. O RouteView para Gateway B é composto por os recursos HTTPRoute do Projeto B e GRPCRoute da o projeto C.

Os relacionamentos entre os recursos "Route", "Routeview" e "Gateway".
As relações entre os recursos "Route", "Routeview" e "Gateway". (clique para ampliar)

O escopo deste recurso é Mesh ou Gateway. Uma RouteView para uma Gateway ou Mesh lista as 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 ver 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 descrevendo cada um deles para uma visão geral completa dos trajetos anexados.

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 nas suas Rotas
    • Reimportar o trajeto
      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 adequada.
    • Modifique a descrição para acionar a automação do Terraform.

A seguir