Répertorier 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 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 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 à 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 un Gateway ou un Mesh liste les routes associées à cet élément, et non toutes les routes associées au champ d'application associé.GatewayMesh

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 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 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 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 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