Apresentar recursos de trajetos

Este documento destina-se aos administradores de malhas que usam as APIs de encaminhamento de serviços para configurar malhas de serviços.

No modelo de API de encaminhamento de serviços, os recursos Route estão anexados a recursos Mesh ou Gateway. Na respetiva configuração, o recurso Mesh ou Gateway faz referência a um ou mais recursos Route.

Se for proprietário de um recurso Mesh ou Gateway, pode listar os recursos Route anexados ao recurso Mesh ou Gateway.

Cada recurso Mesh ou Gateway tem uma coleção secundária sintética de recursos RouteView. Cada RouteView corresponde a um único Route. RouteView objetos são criados juntamente com Route objetos.

No diagrama seguinte, o RouteView para Gateway A consiste nos recursos TCPRoute do projeto A. O RouteView para 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 aumentar)

Esta funcionalidade está ao nível do Mesh ou do Gateway. Um RouteView para uma lista de Gateway ou Mesh de rotas anexadas a esse Gateway ou Mesh e não a todas as rotas anexadas ao âmbito associado.

Para apresentar uma lista dos recursos RouteView, execute o seguinte comando:

gcloud alpha network-services route-views list \
    --location=global \
    --[mesh | gateway]=[ MESH_NAME | GATEWAY_NAME ]

Para obter mais informações sobre o próprio trajeto, execute o seguinte comando: 

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

Um fluxo de trabalho comum seria listar os RouteViews para uma malha ou um gateway e, em seguida, descrever cada um para uma vista geral completa dos trajetos anexados.

Não pode criar, atualizar nem eliminar recursos RouteView. São criados, atualizados e eliminados quando os respetivos recursos Route são criados, atualizados e eliminados.

Resolução de problemas

Se os comandos route-views não conseguirem listar o RouteViews para trajetos como Listed 0 items. ou não listarem todos os trajetos conhecidos:

  • Verifique se a malha ou o gateway usado no route-views list são referenciados nos campos meshes ou gateways da rota, respetivamente, através do seguinte:
    • gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
    --location global ROUTE_ID
  • Para clientes com muitos recursos, crie um pedido de apoio técnico para receber assistência.
  • Acione manualmente uma atualização para as 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 automatização do Terraform.

O que se segue?