Génération d'un rapport de route Direct Link

Vous pouvez générer un rapport de toutes les routes connues d'un lien direct et de ses connexions. Ce rapport vous permet de vérifier les routes prévues, d'afficher les connexions virtuelles qui contribuent aux routes de votre lien direct et d'afficher les détails de l'adresse de tronçon suivant des routes reçues. Si vous utilisez la fonction de liaison VPC inter-comptes, vous pouvez également voir quels préfixes ou sous-réseaux sont acheminés via votre routeur d'interconnexion.

Vous pouvez récupérer un rapport d'itinéraire via l'interface utilisateur, la ligne de commande ou l'API.

Considérations relatives au rapport de route

Passez en revue les remarques suivantes lors de l'utilisation d'un rapport de route:

  • Les rapports d'itinéraires sont destinés à être générés lors de la validation ou du dépannage des modifications apportées à la configuration de Direct Link ou des réseaux connectés. Ils ne sont pas conçus pour une production continue ou automatisée. Les demandes fréquentes ou automatisées peuvent être limitées ou bloquées.
  • Une fois qu'une nouvelle connexion virtuelle (VPC, passerelle classique ou passerelle Transit Gateway) atteint l'état Active, prévoyez 5 minutes pour que les routes soient apprises par votre lien direct. La génération d'un rapport de route avant l'apprentissage de toutes les routes génère un rapport de route partiel.
  • Les routes sur site ne s'affichent que 5 minutes environ après la définition du statut Established pour BGP. Les routes de passerelle ne s'affichent pas tant que la mise à disposition de la passerelle n'est pas terminée.
  • Si une connexion expose une route de 0.0.0.0/0, cette route est ignorée lors du calcul des préfixes qui se chevauchent.
  • Un seul rapport par passerelle est disponible à tout moment. Si vous générez un nouveau rapport, l'ancien rapport sera supprimé.
  • Les rapports de route plus anciens peuvent devenir inexacts une fois que vous avez ajouté ou supprimé une connexion. Par conséquent, si vous modifiez les itinéraires au sein de ces liaisons, il est recommandé de générer un nouveau rapport d'itinéraires.

Génération d'un rapport d'itinéraire à l'aide de l'interface utilisateur

Pour générer un rapport de route à l'aide de l'interface utilisateur, suivez ces étapes :

  1. Dans votre navigateur, ouvrez la console IBM Cloud et connectez-vous à votre compte.

  2. Sélectionnez le site Menu de navigation Icône de menu, puis cliquez sur Infrastructure Icône VPC > Réseau > Lien direct.

  3. Dans le tableau Direct Link, cliquez sur le nom Direct Link pour lequel vous souhaitez générer le rapport.

  4. Sur la page Détails, cliquez sur l'onglet BGP et faites défiler l'écran jusqu'à la vue à onglets Routes. Cliquez ensuite sur le lien Générer un rapport.

    Vous pouvez également utiliser le raccourci Rapport d'acheminement dans l'onglet Présentation.

    Le rapport d'itinéraire commence à s'afficher; sa génération peut prendre quelques minutes, selon la complexité de la liaison directe. Gardez à l'esprit que vous ne pouvez pas générer un autre rapport tant que le traitement du rapport n'est pas terminé ou que vous ne cliquez pas sur Annuler le rapport.

Une fois le rapport généré, les colonnes suivantes s'affichent dans la table du rapport de routage.

  • Route-Indique l'adresse de la route (par exemple, 169.254.0.40/29).

  • Type-Indique le type de route:

    • Connexion-Indique le nom (ou l'ID) de la connexion spécifique dont provient la route.
    • Passerelle - Configurée sur le routeur IBM pour établir BGP.
    • Sur site - Provient de votre centre de données sur site.

    Vous pouvez développer la ligne On-prem pour afficher le chemin AS, le tronçon suivant et les conflits éventuels. Pour les types de connexion, développez la ligne pour afficher le chemin AS, le préfixe local, la source et les conflits éventuels.

  • Annoncé-Indique si la route est annoncée, apprise ou non.

    La route est annoncée uniquement lorsque BGP est établi.

  • Conflit-Indique s'il existe ou non un conflit de route.

Sélectionnez l'icône Paramètres icône Paramètres pour modifier la hauteur de ligne du tableau ou éditer les paramètres de colonne.

Conflits de routes

Les routes en conflit s'affichent dans la colonne Conflit de la vue Routes . Les chevauchements d'itinéraires constituent un problème courant lors de la configuration d'une liaison directe. Si les routes de deux connexions ou plus se chevauchent, il se peut que le trafic ne soit pas correctement acheminé. Exemple :

Afficher le rapport de route
Afficher le rapport de route

S'il existe plusieurs conflits, cliquez sur le lien pour ouvrir un panneau latéral contenant plus d'informations. Une fois les conflits résolus, générez un nouveau rapport.

Génération et affichage d'un rapport de route à l'aide de l'interface de ligne de commande

Pour générer et afficher un rapport de route à l'aide de l'interface de ligne de commande, exécutez la commande suivante :

ibmcloud dl route-report-create|rrc GATEWAY_ID [--output format] [--help|-h]

Où :

  • GATEWAY_ID correspond à l'identifiant de la passerelle.
  • -- sortie json formate la sortie au format JSON.
  • -- help | -h permet d'obtenir de l'aide sur cette commande.

Par exemple, pour créer un rapport d'itinéraire pour une liaison directe :

ibmcloud dl route-report-create a771366f-2c8c-49f6-a23b-9d49fad035a3

Pour plus d'informations, voir les commandes ibmcloud dl route-report.

Génération et affichage d'un rapport de route à l'aide de l'API

Pour générer et afficher un rapport de route à l'aide de l'API, suivez ces étapes :

  1. Configurez votre environnement d'API avec les variables appropriées.

  2. Stockez d'autres variables destinées à être utilisées dans les commandes d'API, par exemple :

    direct_link_id="11111111-b540-4766-a196-14368f328eb2"
    
  3. Création d'un rapport de demande :

    curl -X POST "$directlink_api_endpoint/v1/gateways/$direct_link_id/route_reports?version=$api_version" -H "Authorization: $iam_token"
    

    Pour le reste des appels, vous devez connaître l'ID du rapport nouvellement créé. Sauvegardez l'ID dans une variable, par exemple :

    route_report="22222222-c540-4766-a196-14368f328eb2"
    

    Pour vérifier que la variable a été sauvegardée, exécutez echo $route_report et assurez-vous que la réponse n'est pas vide.

  4. Attendez que le rapport devienne actif, puis vous pouvez afficher ses détails:

    curl -X GET "$directlink_api_endpointv1/gateways/$direct_link_id/route_reports/$route_report?version=$api_version" -H "Authorization: $iam_token"
    

    Pour plus d'informations, voir l'API Gateway Route Reports.