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, los recursos Mesh o Gateway hace referencia a uno o más recursos Route.

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

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

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

Las relaciones entre los recursos "Ruta", "Ruta vista" y "Puerta de enlace"
Las 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 route-views no muestran RouteViews para rutas como Listed 0 items. o no muestran todas las rutas conocidas, haz lo siguiente:

  • Verifica que se haga referencia a la malla o puerta de enlace que se usa en route-views list dentro de los campos meshes o gateways de la ruta, respectivamente, con lo siguiente:
    • gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
          --location global ROUTE_ID
  • En el caso de los clientes con muchos recursos, crea un ticket de asistencia para obtener ayuda.
  • Cómo activar manualmente una actualización de 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?