Listar recursos de "Route"

Este documento é destinado a administradores da 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 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, liste o Route recursos anexados a 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, 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 "Rota", "Routeview" e "Gateway".(clique para ampliar)

O escopo desse 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 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 na route-views list estã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 assistência.
  • 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