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 o 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 de filhos sintéticos de recursos RouteView. Cada RouteView corresponde a um único Route. Objetos RouteView são criados junto com objetos Route.

No diagrama a seguir, o RouteView do Gateway A consiste nos recursos TCPRoute do projeto A. O RouteView do Gateway B compreende 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 tem escopo no 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, 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 em si, emita 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 deles 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 de visualização de rotas 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 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 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