Enumera los 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 la API de enrutamiento del servicio, los recursos Route se adjuntan a los recursos Mesh o Gateway. 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 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 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 para 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`.
Las relaciones entre los recursos "Route", "Routeview" y "Gateway" (haz clic para ampliar)

Esta función se limita al nivel de Mesh o Gateway. Un RouteView para un Gateway o un Mesh enumera las rutas adjuntas a ese Gateway o Mesh, y no todas las rutas adjuntas al alcance 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 enumerar los RouteViews de una malla o puerta de enlace y, luego, describir cada uno para obtener una descripción general completa de las rutas adjuntas.

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

Soluciona problemas

Si los comandos de route-views no pueden enumerar RouteViews para rutas como Listed 0 items. o no enumeran todas las rutas conocidas, haz lo siguiente:

  • Verifica que la malla o la puerta de enlace que se usan en route-views list se hagan referencia 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
  • Si tienes muchos recursos, crea un ticket de asistencia para obtener ayuda.
  • Cómo activar manualmente una actualización 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
    • En el caso de los clientes que usan el cliente de NetworkServices generado, llama a la API de NetworkServices.Update*Route correspondiente.
    • Modifica la descripción para activar la automatización de Terraform.

¿Qué sigue?