Cómo enumerar recursos de `Route`

Este documento está dirigido a los administradores de mallas que usan las APIs de enrutamiento de servicios para configurar mallas de servicios.

En el modelo de la API de enrutamiento de servicios, los recursos Route se conectan a Mesh o Gateway recursos. En su configuración, el recurso Mesh o Gateway hace referencia a uno o más recursos Route.

Si eres propietario de un recurso Mesh o Gateway, puedes enumerar los Route. recursos conectados a Mesh o Gateway.

Cada recurso Mesh o Gateway tiene una colección secundaria sintética de RouteView. de Google Cloud. Cada RouteView corresponde a un solo Route. Los objetos RouteView se crean junto con los objetos Route.

En el siguiente diagrama, RouteView para Gateway A consta de lo siguiente: TCPRoute recursos del proyecto A. El RouteView para Gateway B consta los recursos HTTPRoute del Proyecto B y los recursos GRPCRoute del Proyecto C.

Las relaciones entre los recursos `Route`, `Routeview` y `Gateway`.
Relaciones entre los recursos `Route`, `Routeview` y `Gateway` (haz clic para ampliar)

Esta función se limita al nivel Mesh o Gateway. Un RouteView para un Gateway o Mesh enumeran las rutas adjuntas a esos Gateway o Mesh, y no todas las rutas adjuntadas al permiso asociado.

Para enumerar los recursos RouteView, ejecuta el siguiente comando:

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

Para obtener más información sobre la ruta en sí, ejecuta el siguiente comando: 

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

Un flujo de trabajo común sería mostrar una lista de RouteViews para una malla o una puerta de enlace. y, luego, las describí para obtener una descripción general de las rutas adjuntas.

No puedes crear, actualizar ni borrar recursos RouteView. Se crean, se actualizan y se borran cuando se crean sus recursos Route correspondientes actualización y eliminación.

Soluciona problemas

Si los comandos de vistas de ruta no muestran los elementos RouteView de rutas como Listed 0 items. o no muestra todas las rutas conocidas:

  • Verifica que la malla o puerta de enlace que se usa en route-views list sea a las que se hace referencia en los campos meshes o gateways de la ruta, respectivamente mediante lo siguiente:
    • gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
    --location global ROUTE_ID
  • Los clientes con muchos recursos pueden crear un ticket de asistencia para recibir asistencia.
  • Activa una actualización de forma manual para tus rutas
    • Cómo volver a importar la ruta
      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 los clientes que usan el cliente de NetworkServices generado, llama a la API de NetworkServices.Update*Route adecuada.
    • Modifica la descripción para activar la automatización de Terraform.

¿Qué sigue?