Listar recursos "Route"

Este documento é destinado a administradores de malha 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 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 a ele.MeshGateway

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 junto com os objetos Route.

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

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

Esse recurso está no escopo do nível Mesh ou Gateway. Um RouteView para um 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, execute 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, execute o seguinte comando: 

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

Um fluxo de trabalho comum seria listar os RouteViews de uma malha ou gateway e descrever cada um para ter 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 o 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 são referenciados 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 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 apropriada.
    • Modifique a descrição para acionar a automação do Terraform.

A seguir