Lister les ressources "Route"

Ce document s'adresse aux administrateurs de réseau maillé qui utilisent les API de routage de services pour configurer des maillages de services.

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

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

Chaque ressource Mesh ou Gateway possède une collection enfant synthétique de ressources RouteView. Chaque RouteView correspond à un seul Route. RouteView objet sont créés avec les objets Route.

Dans le schéma suivant, le RouteView pour Gateway A se compose des éléments suivants : 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 Gateway ou Mesh répertorie les routes associées à ce Gateway ou Mesh et non toutes les routes associées au champ d'application associé.

Pour répertorier 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 l'itinéraire lui-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 réseau maillé 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 des 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 à répertorier les routesView pour les routes telles que Listed 0 items. ou ne répertorie pas toutes les routes connues:

  • Vérifiez que le réseau maillé ou la passerelle utilisés dans route-views list sont référencés dans les champs meshes ou gateways du routage, respectivement à l'aide des éléments suivants :
    • 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 une demande d'assistance.
  • Déclencher manuellement une mise à jour de votre ou 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 utilisant 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