Lister les ressources de route

Ce document est destiné aux administrateurs de maillage qui utilisent les API de routage de services pour configurer des maillages de services.

Dans le modèle d'API de routage de services, les ressources Route sont associées à des ressources Mesh ou Gateway. Dans sa configuration, la ressource Mesh ou Gateway fait référence à une ou plusieurs ressources Route.

Si vous êtes propriétaire d'une ressource Mesh ou Gateway, vous pouvez lister les ressources Route associées à Mesh ou Gateway.

Chaque ressource Mesh ou Gateway possède une collection enfant synthétique de ressources RouteView. Chaque RouteView correspond à une seule Route. Les objets RouteView sont créés en même temps que les objets Route.

Dans le schéma suivant, la RouteView de la Gateway A est constituée des ressources TCPRoute du projet A. La RouteView de la Gateway B comprend les ressources HTTPRoute du projet B et les ressources GRPCRoute du projet C.

Relations entre les ressources "Route", "Routeview" et "Gateway".
Relations entre les ressources `Route`, `Routeview` et `Gateway` (cliquez pour agrandir)

Cette fonctionnalité est limitée au niveau Mesh ou Gateway. Une RouteView pour une Gateway ou un Mesh liste les routes associées à cette Gateway ou à ce Mesh, et non toutes les routes associées au champ d'application.

Pour lister les ressources RouteView, exécutez la commande suivante :

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

Pour obtenir plus d'informations sur la route elle-même, exécutez la commande suivante : 

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

Un workflow courant consiste à lister les RouteViews d'un maillage ou d'une passerelle, puis à décrire chacun d'eux pour obtenir une vue d'ensemble complète des routes associées.

Vous ne pouvez pas créer, mettre à jour ni supprimer de ressources RouteView. Elles sont créées, mises à jour et supprimées lorsque leurs ressources Route correspondantes sont créées, mises à jour et supprimées.

Dépannage

Si les commandes route-views ne parviennent pas à lister les RouteViews pour des routes telles que Listed 0 items. ou ne listent pas toutes les routes connues :

  • Vérifiez que le maillage ou la passerelle utilisé dans le route-views list est référencé dans les champs meshes ou gateways de la route, respectivement à l'aide de :
    • gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
    --location global ROUTE_ID
  • Pour les clients disposant de nombreuses ressources, créez un ticket d'assistance pour obtenir de l'aide.
  • Déclenchez manuellement une mise à jour pour votre ou vos routes.
    • Réimporter la route
      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
    • Pour les clients qui utilisent le client NetworkServices généré, appelez l'API NetworkServices.Update*Route appropriée.
    • Modifiez la description pour déclencher l'automatisation Terraform.

Étape suivante