Lister les ressources Route

Ce document s'adresse aux administrateurs de maillage qui utilisent les API de routage de service pour configurer des maillages de services.

Dans le modèle d'API de routage de services, les ressources Route sont associées aux ressources Mesh ou Gateway. Dans sa configuration, la ressource Mesh ou Gateway 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 à la ressource Mesh ou Gateway.

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

Dans le diagramme suivant, le RouteView pour Gateway A se compose des ressources TCPRoute du projet A. Le RouteView pour 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. Un RouteView pour un Gateway ou un Mesh liste les routes associées à ce Gateway ou 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 pour un maillage ou une passerelle, puis à décrire chacun d'eux pour obtenir un aperçu complet 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 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és dans route-views list sont référencés 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
  • Si vous avez de nombreuses ressources, créez une demande d'assistance pour obtenir de l'aide.
  • Déclencher manuellement une mise à jour pour vos itinéraires
    • Réimporter l'itinéraire
      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.

Étapes suivantes