Spécifier et gérer des routes apprises personnalisées.

Cloud Router apprend les routes pour le trafic de sortie de manière dynamique à partir de ses pairs BGP (Border Gateway Protocol). Cependant, vous pouvez également créer manuellement ces routes et les appliquer à une session BGP. Ces routes créées manuellement sont appelées routes apprises personnalisées.

Vous pouvez créer des routes apprises personnalisées en même temps que vous créez une session BGP. Vous pouvez également mettre à jour une session BGP existante pour ajouter des routes apprises personnalisées.

Pour obtenir une présentation des routes apprises personnalisées, consultez la section Routes apprises.

Pour en savoir plus sur la manière dont Cloud Router gère les routes apprises en général, y compris les routes apprises de manière dynamique, consultez la section Routes apprises.

Avant de commencer

Avant de commencer, consultez les sections suivantes.

Sélectionner un projet

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Install the Google Cloud CLI.
  5. To initialize the gcloud CLI, run the following command:

    gcloud init
  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Install the Google Cloud CLI.
  9. To initialize the gcloud CLI, run the following command:

    gcloud init
  1. Si vous utilisez Google Cloud CLI, définissez votre ID de projet en exécutant la commande suivante. Dans les instructions gcloud de cette page, nous partons du principe que vous avez défini l'ID de votre projet.
    gcloud config set project PROJECT_ID
        
  1. Confirmez que l'ID a été défini en exécutant la commande suivante :
    gcloud config list --format='text(core.project)'
        

Configuration requise pour IPv6 (facultatif)

Si vous souhaitez que vos routes apprises personnalisées incluent des préfixes d'adresses IPv6, votre ressource de connectivité doit remplir les conditions sous-jacentes pour IPv6. Par exemple, si vous établissez des routes apprises personnalisées pour un tunnel VPN, assurez-vous que vous remplissez les conditions décrites dans la section Compatibilité IPv6 dans Cloud VPN. Présentation.

Définir des routes apprises personnalisées lors de la création d'une session

Pour certains produits de connectivité réseau, vous pouvez configurer un pair BGP pour inclure les routes apprises personnalisées lors de la création de la ressource. Pour les autres ressources, vous devez d'abord créer la session BGP, puis ajouter les routes apprises personnalisées ultérieurement.

Pour savoir comment ajouter des routes apprises personnalisées lors de la création d'une session, consultez les articles suivants :

Si vous créez un rattachement de VLAN d'interconnexion partenaire, commencez par créer le rattachement, puis mettez à jour le pair BGP pour ajouter des routes apprises personnalisées.

Si vous installez un dispositif virtuel de réseau tiers à l'aide de Network Connectivity Center et que vous souhaitez utiliser des routes apprises personnalisées, commencez par installer le dispositif. Ensuite, pour chaque route apprise personnalisée que vous souhaitez utiliser, connectez-vous au serveur et configurez votre instance d'appareil de routeur pour utiliser les routes apprises personnalisées. Vous pouvez ensuite mettre à jour la session BGP pour utiliser des routes apprises personnalisées. Pour en savoir plus, consultez la page Utiliser des routes apprises personnalisées dans la documentation du Network Connectivity Center.

Lorsque vous mettez à jour une session Cloud Router, le routeur Cloud Router recherche les chevauchements entre les routes apprises personnalisées et les sous-réseaux VPC. En cas de chevauchement, le sous-réseau VPC est prioritaire. Cela signifie que le trafic est acheminé via le sous-réseau VPC plutôt que via la route apprise personnalisée. Cloud Router ignore les routes BGP et les routes apprises personnalisées qui sont plus spécifiques ou égales au sous-réseau VPC. Pour plus d'informations sur le routage dans Google Cloud, consultez la page Routes.

Si une route BGP et une route apprise personnalisée correspondent à la même adresse IP de destination, Google Cloud donne la priorité aux routes ayant une valeur de priorité plus faible. Les valeurs inférieures indiquent une priorité plus élevée.

Pour savoir comment ajouter des routes apprises personnalisées lors de la mise à jour d'une session BGP, consultez la section suivante.

Mettre à jour une session existante pour utiliser des routes apprises personnalisées

Si une session BGP existante n'est associée à aucune route apprise personnalisée, vous pouvez la mettre à jour pour utiliser des routes apprises personnalisées.

Vous pouvez également utiliser cette procédure si vous avez déjà configuré des routes apprises personnalisées pour une session, mais que vous souhaitez ajouter le préfixe d'adresse IP que vous avez spécifié précédemment.

Console

  1. Dans Google Cloud Console, accédez à la page Routeurs cloud.

    Accéder aux routeurs cloud

  2. Dans le champ Nom, cliquez sur le nom du routeur Cloud Router approprié.

  3. Sur la page Détails du routeur, cliquez sur le nom de la session BGP à modifier.

  4. Sur la page d'informations de la session BGP, cliquez sur Modifier.

  5. Développez la section Routes annoncées, routes apprises personnalisées, détection de transfert bidirectionnel (BFD), puis dans la section Routes apprises personnalisées, procédez comme suit :

    1. Dans la section Priorité de toutes les routes apprises personnalisées, pour configurer la priorité de la route, saisissez une valeur de priorité comprise entre 0 et 65535 (inclus) pour toutes les routes apprises personnalisées configurées pour cette session.

      Google Cloud privilégie les routes dont les valeurs de priorité sont plus faibles. Si la même plage d'adresses IP est configurée dans plusieurs routes apprises personnalisées, la meilleure sélection de chemin est basée sur la priorité de la route.

    2. Cliquez sur Ajouter une plage d'adresses IP.

    3. Dans le champ Plage d'adresses IP, saisissez un préfixe IPv4 ou IPv6. Si vous fournissez une adresse IP sans masque de sous-réseau, elle est considérée comme ayant un masque de sous-réseau /32 (pour IPv4) et un masque de sous-réseau /128 (pour IPv6).

  6. Cliquez sur Enregistrer.

gcloud

Exécutez la commande gcloud compute routers update-bgp-peer :

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --peer-name=PEER_NAME \
      --region=REGION \
      --add-custom-learned-route-ranges=IP_PREFIXES \
      --custom-learned-route-priority=ROUTE_PRIORITY

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeur cloud
  • PEER_NAME : nom du pair BGP
  • REGION : région où se trouve le routeur cloud.
  • IP_PREFIXES : liste de préfixes IPv4 ou IPv6 séparés par une virgule, par exemple, 192.0.2.0/24,198.51.100.0/24,2001:db8:abcd:12::/64

    Si vous fournissez un préfixe d'adresse IP sans masque de sous-réseau, celui-ci est interprété comme un masque de sous-réseau /32 (pour IPv4) et un masque de sous-réseau /128 (pour IPv6). Pour en savoir plus sur le nombre maximal de routes apprises personnalisées que vous pouvez posséder, consultez la section Limites.

  • ROUTE_PRIORITY : valeur de priorité comprise entre 0 et 65535 (inclus) pour toutes les routes apprises personnalisées pour cette session

    Google Cloud privilégie les routes dont les valeurs de priorité sont plus faibles. Autrement dit, une route avec une priorité de 100 dispose d'une préférence supérieure à une route avec une priorité de 200. Si vous ne fournissez pas de valeur, Google Cloud applique en interne une valeur 100.

API

Utilisez la méthode compute.routers.patch et mettez à jour le tableau bgpPeers.

Lorsque vous appliquez un correctif au tableau bgpPeers, vous devez fournir des valeurs pour chaque champ de chaque élément (sauf si vous souhaitez supprimer des pairs BGP ou certaines valeurs).

Par exemple, supposons que le routeur Cloud Router ait deux pairs BGP. Pour ne pas modifier le premier pair BGP, mais ajouter deux routes apprises personnalisées au deuxième pair BGP, exécutez une requête semblable à celle-ci :

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "bgpPeers": [
      {
        "name": "PEER_NAME_1",
        "interfaceName": "INTERFACE_NAME_1",
        "ipAddress": "IP_ADDRESS_1",
        "peerIpAddress": "PEER_IP_ADDRESS_1",
        "peerAsn": "PEER_ASN_1"
      },
      {
        "name": "PEER_NAME_2",
        "interfaceName": "INTERFACE_NAME_2",
        "ipAddress": "IP_ADDRESS_2",
        "peerIpAddress": "PEER_IP_ADDRESS_2",
        "peerAsn": "PEER_ASN_2",
        "customLearnedRoutePriority": "ROUTE_PRIORITY",
        "customLearnedIpRanges": [
         {
          "range": "IP_PREFIX_1"
         },
         {
          "range": "IP_PREFIX_2"
         }
       ]
      }
    ]
  }

Remplacez les valeurs d'espace réservé comme suit.

Indiquez des valeurs pour Cloud Router :

  • PROJECT_ID : projet contenant le routeur cloud.
  • REGION : région où se trouve le routeur cloud.
  • ROUTER_NAME : nom du routeur cloud

Fournissez des valeurs sur la session d'appairage BGP que vous ne modifiez pas :

  • PEER_NAME_1 : nom de la session BGP
  • INTERFACE_NAME_1 : nom de l'interface utilisée par la session
  • IP_ADDRESS_1 : adresse IP du routeur Cloud Router utilisée par la session BGP
  • PEER_IP_ADDRESS_1 : adresse IP du pair BGP
  • PEER_ASN_1 : numéro ASN (Autonomous System Number) de la session

Fournissez des valeurs sur la session d'appairage BGP à laquelle vous souhaitez ajouter des routes apprises personnalisées :

  • PEER_NAME_2 : nom de la session BGP
  • INTERFACE_NAME_2 : nom de l'interface utilisée par la session
  • IP_ADDRESS_2 : adresse IP du routeur Cloud Router utilisée par la session BGP
  • PEER_IP_ADDRESS_2 : adresse IP du pair BGP
  • PEER_ASN_2 : numéro ASN (Autonomous System Number) de la session
  • ROUTE_PRIORITY : valeur de priorité comprise entre 0 et 65535 (inclus) pour toutes les routes apprises personnalisées pour cette session

    Google Cloud privilégie les routes dont les valeurs de priorité sont plus faibles. Autrement dit, une route avec une priorité de 100 dispose d'une préférence supérieure à une route avec une priorité de 200. Si vous ne fournissez pas de valeur, Google Cloud applique en interne une valeur 100.

  • IP_PREFIX_1 et IP_PREFIX_2 : pour chacun de ces champs, saisissez un préfixe IPv4 ou IPv6

    Si vous fournissez un préfixe d'adresse IP sans masque de sous-réseau, celui-ci est interprété, pour IPv4, comme un masque de sous-réseau /32 et, pour IPv6, /128. Pour en savoir plus sur le nombre maximal de routes apprises personnalisées que vous pouvez posséder, consultez la section Limites.

Remplacer les routes apprises personnalisées existantes

Si vous souhaitez remplacer les routes apprises personnalisées définies pour une session BGP, suivez les instructions ci-dessous. Lorsque vous utilisez cette procédure, les routes apprises personnalisées existantes sont supprimées au profit des nouvelles routes que vous définissez.

Console

  1. Dans Google Cloud Console, accédez à la page Routeurs cloud.

    Accéder aux routeurs cloud

  2. Dans le champ Nom, cliquez sur le nom du routeur Cloud Router approprié.

  3. Sur la page Détails du routeur, cliquez sur le nom de la session BGP à modifier.

  4. Sur la page d'informations de la session BGP, cliquez sur Modifier.

  5. Développez la section Routes annoncées, routes apprises personnalisées, détection de transfert bidirectionnel (BFD).

  6. Dans le champ Plage d'adresses IP, modifiez le préfixe IPv4 ou IPv6. Si vous fournissez un préfixe d'adresse IP sans masque de sous-réseau, celui-ci est interprété comme un masque de sous-réseau /32 (pour IPv4) et un masque de sous-réseau /128 (pour IPv6).

  7. Cliquez sur Enregistrer.

gcloud

Utilisez la commande gcloud compute routers update-bgp-peer. Vous pouvez utiliser l'option set-custom-learned-route-ranges pour spécifier de nouveaux préfixes IP ou pour supprimer des préfixes définis précédemment :

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --peer-name=PEER_NAME \
      --region=REGION \
      --set-custom-learned-route-ranges=IP_PREFIXES

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeur cloud
  • PEER_NAME : nom du pair BGP
  • REGION : région où se trouve le routeur cloud.
  • IP_PREFIXES : liste de préfixes IPv4 ou IPv6 séparés par une virgule, par exemple, 1.2.3.4,6.7.0.0,2001:db8:abcd:12::/64

    Si vous fournissez un préfixe d'adresse IP sans masque de sous-réseau, celui-ci est interprété, pour IPv4, comme un masque de sous-réseau /32 et, pour IPv6, /128. Pour effacer tous les préfixes, utilisez l'option sans valeur après. Pour en savoir plus sur le nombre maximal de routes apprises personnalisées que vous pouvez posséder, consultez la section Limites.

API

Utilisez la méthode compute.routers.patch et mettez à jour le tableau bgpPeers.

Lorsque vous appliquez un correctif au tableau bgpPeers, vous devez fournir des valeurs pour chaque champ de chaque élément (sauf si vous souhaitez supprimer des pairs BGP ou certaines valeurs).

Par exemple, supposons que le routeur Cloud Router ait deux pairs. Supposons que l'un n'utilise pas de routes apprises personnalisées, mais que l'autre les utilise. Pour ne pas modifier le premier pair, mais remplacer les routes définies pour le deuxième pair, utilisez une requête semblable à celle-ci :

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "bgpPeers": [
      {
        "name": "PEER_NAME_1",
        "interfaceName": "INTERFACE_NAME_1",
        "ipAddress": "IP_ADDRESS_1",
        "peerIpAddress": "PEER_IP_ADDRESS_1",
        "peerAsn": "PEER_ASN_1"
      },
      {
        "name": "PEER_NAME_2",
        "interfaceName": "INTERFACE_NAME_2",
        "ipAddress": "IP_ADDRESS_2",
        "peerIpAddress": "PEER_IP_ADDRESS_2",
        "peerAsn": "PEER_ASN_2",
        "customLearnedRoutePriority": "ROUTE_PRIORITY",
        "customLearnedIpRanges": [
          {
           "range": "IP_PREFIX_1"
          },
          {
           "range": "IP_PREFIX_2"
          }
         ]
       }
     ]
   }

Remplacez les valeurs d'espace réservé comme suit.

Indiquez des valeurs pour Cloud Router :

  • PROJECT_ID : projet contenant le routeur cloud.
  • REGION : région où se trouve le routeur cloud.
  • ROUTER_NAME : nom du routeur cloud

Fournissez des valeurs sur la session d'appairage BGP que vous ne modifiez pas :

  • PEER_NAME_1 : nom de la session BGP
  • INTERFACE_NAME_1 : nom de l'interface utilisée par la session
  • IP_ADDRESS_1 : adresse IP du routeur Cloud Router utilisée par la session
  • PEER_IP_ADDRESS_1 : adresse IP du pair BGP
  • PEER_ASN_1 : numéro ASN (Autonomous System Number) de la session

Indiquez les valeurs de la session d'appairage BGP vers laquelle vous souhaitez écraser les routes apprises personnalisées :

  • PEER_NAME_2 : nom de la session BGP
  • INTERFACE_NAME_2 : nom de l'interface utilisée par la session
  • IP_ADDRESS_2 : adresse IP du routeur Cloud Router utilisée par la session
  • PEER_IP_ADDRESS_2 : adresse IP du pair BGP
  • PEER_ASN_2 : numéro ASN (Autonomous System Number) de la session
  • ROUTE_PRIORITY : valeur de priorité comprise entre 0 et 65535 (inclus) pour toutes les routes personnalisées apprises pour cette session.

    Google Cloud privilégie les routes dont les valeurs de priorité sont plus faibles. Autrement dit, une route avec une priorité de 100 dispose d'une préférence supérieure à une route avec une priorité de 200. Si vous ne fournissez pas de valeur, Google Cloud applique en interne une valeur 100.

  • IP_PREFIX_1 et IP_PREFIX_2 : pour chacun de ces champs, saisissez un préfixe IPv4 ou IPv6

    Si vous fournissez une adresse IP sans masque de sous-réseau, elle est interprétée comme, pour IPv4, un masque de sous-réseau /32 et, pour IPv6, /128. Pour en savoir plus sur le nombre maximal de routes apprises personnalisées que vous pouvez posséder, consultez la section Limites.

Supprimer les routes apprises personnalisées d'une session BGP

Pour supprimer tout ou partie des routes personnalisées apprises d'une session BGP, suivez les instructions ci-dessous.

Console

  1. Dans Google Cloud Console, accédez à la page Routeurs cloud.

    Accéder aux routeurs cloud

  2. Dans le champ Nom, cliquez sur le nom du routeur Cloud Router approprié.

  3. Sur la page Détails du routeur, cliquez sur le nom de la session BGP à modifier.

  4. Sur la page d'informations de la session BGP, cliquez sur Modifier.

  5. Développez la section Routes annoncées, routes apprises personnalisées, détection de transfert bidirectionnel (BFD).

  6. Dans la section Routes apprises personnalisées, à côté de la plage d'adresses IP que vous souhaitez supprimer, cliquez sur Supprimer la plage d'adresses IP

  7. Cliquez sur Enregistrer.

gcloud

Exécutez la commande gcloud compute routers update-bgp-peer :

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --peer-name=PEER_NAME \
      --region=REGION \
      --remove-custom-learned-route-ranges=IP_PREFIXES

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeur cloud
  • PEER_NAME : nom du pair BGP
  • REGION : région où se trouve le routeur cloud.
  • IP_PREFIXES : liste des préfixes IP que vous souhaitez supprimer, séparés par une virgule

API

Utilisez la méthode compute.routers.patch et mettez à jour le tableau bgpPeers.

Lorsque vous appliquez un correctif au tableau bgpPeers, vous devez fournir des valeurs pour chaque champ de chaque élément (sauf si vous souhaitez supprimer des pairs BGP ou certaines valeurs).

Par exemple, supposons que le routeur Cloud Router ait deux pairs BGP. Supposons que l'un n'utilise pas de routes apprises personnalisées, mais que l'autre les utilise. Pour ne pas modifier le premier pair et supprimer les routes définies pour le deuxième pair, exécutez une requête comme celle-ci :

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "bgpPeers": [
      {
        "name": "PEER_NAME_1",
        "interfaceName": "INTERFACE_NAME_1",
        "ipAddress": "IP_ADDRESS_1",
        "peerIpAddress": "PEER_IP_ADDRESS_1",
        "peerAsn": "PEER_ASN_1"
      },
      {
        "name": "PEER_NAME_2",
        "interfaceName": "INTERFACE_NAME_2",
        "ipAddress": "IP_ADDRESS_2",
        "peerIpAddress": "PEER_IP_ADDRESS_2",
        "peerAsn": "PEER_ASN_2"
      }
    ]
  }

Remplacez les valeurs d'espace réservé comme suit.

Indiquez des valeurs pour Cloud Router :

  • PROJECT_ID : projet contenant le routeur cloud.
  • REGION : région où se trouve le routeur cloud.
  • ROUTER_NAME : nom du routeur cloud

Fournissez des valeurs sur la session d'appairage BGP que vous ne modifiez pas :

  • PEER_NAME_1 : nom de la session BGP
  • INTERFACE_NAME_1 : nom de l'interface utilisée par la session
  • IP_ADDRESS_1 : adresse IP du routeur Cloud Router utilisée par la session
  • PEER_IP_ADDRESS_1 : adresse IP du pair BGP
  • PEER_ASN_1 : numéro ASN (Autonomous System Number) de la session

Indiquez des valeurs sur la session d'appairage BGP de laquelle vous souhaitez supprimer les routes apprises personnalisées :

  • PEER_NAME_2 : nom de la session
  • INTERFACE_NAME_2 : nom de l'interface utilisée par la session
  • IP_ADDRESS_2 : adresse IP du routeur Cloud Router utilisée par la session
  • PEER_IP_ADDRESS_2 : adresse IP du pair BGP
  • PEER_ASN_2 : numéro ASN (Autonomous System Number) de la session

Modifier la priorité de toutes les routes apprises personnalisées sur une session BGP

Si vous souhaitez mettre à jour une session BGP pour utiliser une priorité différente pour ses routes apprises personnalisées, suivez les instructions ci-dessous. Sachez que la priorité s'applique toujours à toutes les routes personnalisées définies pour un pair BGP. Vous ne pouvez pas appliquer différentes priorités à différents préfixes d'adresses IP.

Console

  1. Dans Google Cloud Console, accédez à la page Routeurs cloud.

    Accéder aux routeurs cloud

  2. Dans le champ Nom, cliquez sur le nom du routeur Cloud Router approprié.

  3. Sur la page Détails du routeur, cliquez sur le nom de la session BGP à modifier.

  4. Sur la page d'informations de la session BGP, cliquez sur Modifier.

  5. Développez la section Routes annoncées, routes apprises personnalisées, détection de transfert bidirectionnel (BFD).

  6. Dans la section Priorité de toutes les routes apprises personnalisées, pour configurer la priorité de la route, saisissez une valeur de priorité comprise entre 0 et 65535 (inclus) pour toutes les routes apprises personnalisées configurées pour cette session.

    Google Cloud privilégie les routes dont les valeurs de priorité sont plus faibles. Si la même plage d'adresses IP est configurée dans plusieurs routes apprises personnalisées, le choix du meilleur chemin est basé sur la priorité de la route.

  7. Cliquez sur Enregistrer.

gcloud

Exécutez la commande gcloud compute routers update-bgp-peer :

  gcloud compute routers update-bgp-peer ROUTER_NAME \
      --peer-name=PEER_NAME \
      --region=REGION \
      --custom-learned-route-priority=NEW_ROUTE_PRIORITY

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeur cloud
  • PEER_NAME : nom du pair BGP
  • REGION : région où se trouve le routeur cloud.
  • NEW_ROUTE_PRIORITY : valeur de priorité comprise entre 0 et 65535 (inclus) pour toutes les routes apprises personnalisées pour cette session

    Google Cloud privilégie les routes dont les valeurs de priorité sont plus faibles. Autrement dit, une route avec une priorité de 100 dispose d'une préférence supérieure à une route avec une priorité de 200.

API

Utilisez la méthode compute.routers.patch et mettez à jour le tableau bgpPeers.

Lorsque vous appliquez un correctif au tableau bgpPeers, vous devez fournir des valeurs pour chaque champ de chaque élément, sauf si vous souhaitez supprimer des pairs BGP ou certaines valeurs.

Par exemple, supposons que le routeur Cloud Router ait deux pairs BGP. Pour laisser le premier pair inchangé, mais mettre à jour la priorité des deux routes apprises personnalisées définies pour le deuxième pair, utilisez une requête semblable à celle-ci :

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "bgpPeers": [
      {
        "name": "PEER_NAME_1",
        "interfaceName": "INTERFACE_NAME_1",
        "ipAddress": "IP_ADDRESS_1",
        "peerIpAddress": "PEER_IP_ADDRESS_1",
        "peerAsn": "PEER_ASN_1"
      },
      {
        "name": "PEER_NAME_2",
        "interfaceName": "INTERFACE_NAME_2",
        "ipAddress": "IP_ADDRESS_2",
        "peerIpAddress": "PEER_IP_ADDRESS_2",
        "peerAsn": "PEER_ASN_2",
        "customLearnedRoutePriority": "NEW_ROUTE_PRIORITY",
        "customLearnedIpRanges": [
          {
           "range": "IP_PREFIX_1"
          },
          {
           "range": "IP_PREFIX_2"
          }
        ]
      }
    ]
  }

Remplacez les valeurs d'espace réservé comme suit.

Indiquez des valeurs pour Cloud Router :

  • PROJECT_ID : projet contenant le routeur cloud.
  • REGION : région où se trouve le routeur cloud.
  • ROUTER_NAME : nom du routeur cloud

Fournissez des valeurs sur la session d'appairage BGP que vous ne modifiez pas :

  • PEER_NAME_1 : nom de la session BGP
  • INTERFACE_NAME_1 : nom de l'interface utilisée par la session
  • IP_ADDRESS_1 : adresse IP du routeur Cloud Router utilisée par la session
  • PEER_IP_ADDRESS_1 : adresse IP du pair BGP
  • PEER_ASN_1 : numéro ASN (Autonomous System Number) de la session

Indiquez les valeurs de la session d'appairage BGP pour laquelle vous souhaitez modifier la priorité :

  • PEER_NAME_2 : nom de la session BGP
  • INTERFACE_NAME_2 : nom de l'interface utilisée par la session
  • IP_ADDRESS_2 : adresse IP du routeur Cloud Router utilisée par la session
  • PEER_IP_ADDRESS_2 : adresse IP du pair BGP
  • PEER_ASN_2 : numéro ASN (Autonomous System Number) de la session
  • NEW_ROUTE_PRIORITY : valeur de priorité comprise entre 0 et 65535 (inclus) pour toutes les routes apprises personnalisées pour cette session

    Google Cloud privilégie les routes dont les valeurs de priorité sont plus faibles. Autrement dit, une route avec une priorité de 100 dispose d'une préférence supérieure à une route avec une priorité de 200.

  • IP_PREFIX_1 et IP_PREFIX_2 : préfixes d'adresses IP déjà définis pour la session BGP

Vérifier l'état des routes apprises personnalisées

Pour vérifier l'état de vos routes apprises personnalisées, suivez les instructions ci-dessous.

Console

  1. Dans Google Cloud Console, accédez à la page Routeurs cloud.

    Accéder aux routeurs cloud

  2. Dans le champ Nom, cliquez sur le nom du routeur Cloud Router approprié.

  3. Sur la page Détails du routeur, cliquez sur le nom de la session BGP à modifier.

  4. Sur la page d'informations de la session BGP, cliquez sur Modifier.

  5. Développez la section Routes annoncées, routes apprises personnalisées, détection de transfert bidirectionnel (BFD).

  6. Pour afficher la priorité des routes, consultez le champ Priorité de toutes les routes apprises personnalisées.

    Google Cloud privilégie les routes dont les valeurs de priorité sont plus faibles. Autrement dit, une route avec une priorité de 100 dispose d'une préférence supérieure à une route avec une priorité de 200.

  7. Pour afficher les plages d'adresses IP, consultez les champs Plage d'adresses IP.

gcloud

  1. Pour vérifier la configuration de vos sessions BGP, exécutez la commande gcloud compute routers describe. Exemple :

    gcloud compute routers describe ROUTER_NAME \
        --region=REGION

    Remplacez les éléments suivants :

    • ROUTER_NAME : nom du routeur cloud
    • REGION : région où se trouve le routeur cloud.

    La sortie de la commande inclut les préfixes d'adresses IP et la priorité configurés pour chaque session BGP.

  2. Pour savoir si l'une de vos routes apprises personnalisées est considérée comme la meilleure route pour le routeur, utilisez la commande gcloud compute routers get-status :

    gcloud compute routers get-status ROUTER_NAME \
        --region=REGION

    Remplacez les éléments suivants :

    • ROUTER_NAME : nom du routeur cloud
    • REGION : région Google Cloud

    Le résultat affiche les meilleures routes pour le routeur Cloud Router et vous indique l'état de chaque session BGP.

API

  1. Pour récupérer les détails de la configuration de session BGP, utilisez la méthode routers.get :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    

    Remplacez les éléments suivants :

    • PROJECT_ID : projet contenant le routeur cloud.
    • REGION : région où se trouve le routeur cloud.
    • ROUTER_NAME : nom du routeur cloud

    Le champ bgpPeers de la sortie contient la configuration de chaque session BGP.

  2. Utilisez la méthode routers.getRouterStatus :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus
    

    Remplacez les éléments suivants :

    • PROJECT_ID : projet contenant le routeur cloud.
    • REGION : région où se trouve le routeur cloud.
    • ROUTER_NAME : nom du routeur cloud

    Le résultat affiche les meilleures routes pour le routeur Cloud Router et vous indique l'état de chaque session BGP.

Étapes suivantes

  • Pour plus d'informations sur l'état d'une session BGP, consultez la section États des sessions BGP.

  • Pour résoudre les problèmes liés à Cloud Router, consultez la page Dépannage.