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 uma única Route. RouteView objeto são criados junto com objetos Route.

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

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

Esse recurso está limitado ao nível 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, em seguida, descrever cada um para uma visão geral completa das rotas anexadas.

Não é possível criar, atualizar ou excluir recursos do 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 sem uma lista de 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 assistência.
  • 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