Mostrar recursos de ruta

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 API de enrutamiento de servicios, los recursos Route se adjuntan a recursos Mesh o Gateway. En su configuración, el recurso Mesh o Gateway hace referencia a uno o varios recursos Route.

Si eres el propietario de un recurso Mesh o Gateway, puedes consultar los recursos Route adjuntos al recurso Mesh o Gateway.

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

En el siguiente diagrama, el RouteView de Gateway A consta de los recursos TCPRoute del proyecto A. El RouteView de Gateway B incluye 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 en la imagen para ampliarla)

Esta función se limita al nivel de Mesh o Gateway. Un RouteView de un Gateway o un Mesh muestra las rutas asociadas a ese Gateway o Mesh, y no todas las rutas asociadas al ámbito correspondiente.

Para enumerar los recursos de 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, ejecuta el siguiente comando: 

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

Un flujo de trabajo habitual sería enumerar los RouteViews de una malla o una pasarela y, a continuación, describir cada uno de ellos para obtener una visión general completa de las rutas asociadas.

No puedes crear, actualizar ni eliminar recursos RouteView. Se crean, actualizan y eliminan cuando se crean, actualizan y eliminan los recursos de Route correspondientes.

Solución de problemas

Si los comandos de route-views no muestran RouteViews para rutas como Listed 0 items. o no muestran todas las rutas conocidas:

  • Verifica que la malla o la pasarela usadas en route-views list se hayan referenciado 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
  • Si tienes muchos recursos, crea una incidencia para obtener ayuda.
  • Activar manualmente una actualización de tus rutas
    • Reimportar 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
    • Los clientes que usen el cliente de NetworkServices generado deben llamar a la API NetworkServices.Update*Route correspondiente.
    • Modifica la descripción para activar la automatización de Terraform.

Siguientes pasos