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 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 "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 enumera las rutas adjuntas a ese Gateway o Mesh, y no todas las rutas adjuntas al alcance asociado.

Para enumerar los recursos RouteView, emite 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 el 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 RouteView. Se crean, actualizan y borran cuando se crean, actualizan y borran sus recursos Route correspondientes.

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 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.
  • 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?