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 de l'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 le propriétaire d'une ressource Mesh ou Gateway, vous pouvez lister les Route ressources associées à Mesh ou Gateway.

Chaque ressource Mesh ou Gateway possède une collection enfant synthétique de RouteView. ressources. Chaque RouteView correspond à un seul Route. Les objets RouteView sont créés avec 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 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 en savoir plus 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 à répertorier le RouteViews pour un réseau maillé ou une passerelle puis en décrivant chacune d'elles 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 à lister les RouteViews pour des routes telles que Listed 0 items. ou ne listent 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 vos routes
    • 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.

Étape suivante