Créer et gérer des routeurs

Cette page explique comment créer et gérer des ressources de routeur Google Distributed Cloud connecté dans une zone Distributed Cloud.

Cette fonctionnalité n'est disponible que sur les racks Distributed Cloud connecté. Les serveurs Distributed Cloud connecté ne sont pas compatibles avec les ressources de routeur.

Pour en savoir plus sur les routeurs Distributed Cloud, consultez la page Fonctionnement de Distributed Cloud connecté.

Tenez bien compte des éléments suivants :

  • Vous pouvez créer un routeur par réseau Distributed Cloud.

  • Nous vous recommandons de créer un routeur en même temps que le rattachement d'interconnexion correspondant. Pour en savoir plus sur la création d'un rattachement d'interconnexion, consultez la page Créer un rattachement d'interconnexion.

Créer un routeur

Pour créer un routeur Distributed Cloud, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau Edge (roles/edgenetwork.admin) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers create :

gcloud edge-cloud networking routers create ROUTER_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --asn=ASN

Remplacez les éléments suivants :

  • ROUTER_NAME: nom descriptif qui identifie de manière unique ce routeur.
  • NETWORK_NAME: nom du réseau desservi par ce routeur.
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.
  • ASN: numéro de système autonome (ASN) de ce routeur. Vous pouvez spécifier une valeur de deux ou quatre octets. Les valeurs ASN publiques et privées sont acceptées.

API

Envoyez une requête POST à la méthode projects.locations.zones.routers.create :

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?routerId=ROUTER_ID
{
 "labels": { LABELS,
  },
 "network": { NETWORK_NAME,
  },
 "asn": { ASN,
  },      
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projetcible. Google Cloud
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.
  • ROUTER_ID : ID qui identifie de manière unique ce routeur.
  • LABELS: liste des libellés à appliquer à cette ressource de routeur.
  • NETWORK_NAME: nom du réseau desservi par ce routeur.
  • ASN: numéro de système autonome (ASN) de ce routeur. Vous pouvez spécifier une valeur de deux ou quatre octets. Les valeurs ASN publiques et privées sont acceptées.

Établir une session d'appairage BGP sur un routeur

Un routeur vous permet d'établir les types de sessions d'appairage BGP (Border Gateway Protocol) suivants :

Une session d'appairage BGP est établie en ajoutant une interface au routeur pour le composant de réseau Distributed Cloud qui correspond au type de session d'appairage.

Établir une session d'appairage en amont

Pour établir une session d'appairage en amont sur un routeur avec un rattachement d'interconnexion, suivez les étapes décrites dans cette section. Le rattachement d'interconnexion cible doit être associé au routeur cible.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau Edge (roles/edgenetwork.admin) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers add-interface :

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --interconnect-attachment=ATTACHMENT_NAME \
    --ip-address=INTERCONNECT_ADDRESS \
    --ip-mask-length=IP_MASK_LENGTH \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeurcible.
  • INTERFACE_NAME : nom descriptif de cette interface.
  • ATTACHMENT_NAME: nom du rattachement d'interconnexion cible dans le routeur cible.
  • INTERCONNECT_ADDRESS: adresse IP de l'interconnexion sur laquelle le rattachement d'interconnexion cible est configuré.
  • IP_MASK_LENGTH: longueur du masque de l'adresse IP d'interconnexion spécifiée.
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.

Établir une session d'appairage en aval

Pour établir une session d'appairage en aval sur un routeur avec un sous-réseau, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau Edge (roles/edgenetwork.admin) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers add-interface :

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --subnet=SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeurcible.
  • INTERFACE_NAME : nom descriptif de cette interface.
  • SUBNETWORK_NAME : nom du sous-réseau cible.
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.

Établir une session d'appairage de bouclage

Pour établir une session d'appairage de bouclage sur un routeur avec un réseau, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau Edge (roles/edgenetwork.admin) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers add-interface :

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --loopback-ip-addresses=LOOPBACK_ADDRESSES \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeurcible.
  • INTERFACE_NAME : nom descriptif de cette interface.
  • LOOPBACK_ADDRESSES: adresses IPv4 entrantes et sortantes de l'interface de bouclage, séparées par une virgule.
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.

Arrêter une session d'appairage BGP

Pour arrêter une session d'appairage BGP entre un routeur et un rattachement d'interconnexion, un sous-réseau ou un réseau, vous devez supprimer l'interface de ce composant réseau du routeur cible. Pour supprimer l'interface, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau Edge (roles/edgenetwork.admin) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers remove-interface :

gcloud edge-cloud networking routers remove-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeurcible.
  • INTERFACE_NAME : nom descriptif de cette interface.
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.

Configurer des pairs dans une session d'appairage BGP

Vous pouvez ajouter et supprimer des pairs BGP dans une session d'appairage BGP établie entre un routeur et un rattachement d'interconnexion, un sous-réseau ou un réseau. Lorsque vous ajoutez un pair à une session d'appairage BGP, la détection de transfert bidirectionnel (BFD) est automatiquement activée sur le routeur cible avec un intervalle de 100 ms, une fenêtre de réception minimale de 100 ms et un multiplicateur de 3.

Une fois que vous avez ajouté un pair à la session d'appairage BGP cible, vous pouvez attribuer l'adresse IP du pair au pod qui exécute votre charge de travail. Pour trouver l'adresse IP du pair, suivez les étapes décrites dans la section Obtenir des informations sur un routeur.

Ajouter un pair à une session d'appairage BGP

Pour ajouter un pair à une session d'appairage BGP, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau Edge (roles/edgenetwork.admin) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers add-bgp-peer :

gcloud edge-cloud networking routers add-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --peer-asn=PEER_ASN \
    --peer-ipv4-range=PEER_IPv4_RANGE \
    --peer-ipv6-range=PEER_IPv6_RANGE \        
    --interface=INTERFACE_NAME \                                                       \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeurcible.
  • PEER_NAME : nom descriptif de ce pair.
  • PEER_ASN: numéro de système autonome (ASN) de ce pair. Vous pouvez spécifier une valeur de deux ou quatre octets. Les valeurs ASN publiques et privées sont acceptées.
  • PEER_IPv4_RANGE : plage CIDR IPv4 de ce pair. Cette plage d'adresses doit se trouver dans le même sous-réseau que l'adresse IP ou la plage d'adresses du rattachement d'interconnexion, du sous-réseau ou du réseau associé.
  • PEER_IPv6_RANGE : plage CIDR IPv6 de ce pair. Cette plage d'adresses doit se trouver dans le même sous-réseau que l'adresse IP ou la plage d'adresses du rattachement d'interconnexion, du sous-réseau ou du réseau associé.
  • INTERFACE_NAME: nom de l'interface qui correspond à la session BGP cible.
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.

Supprimer un pair d'une session d'appairage BGP

Pour supprimer un pair d'une session d'appairage BGP, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau Edge (roles/edgenetwork.admin) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers remove-bgp-peer :

gcloud edge-cloud networking routers remove-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeurcible.
  • PEER_NAME : nom du paircible.
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.

Obtenir la liste des routeurs

Pour répertorier les routeurs provisionnés dans une zone Distributed Cloud connecté, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Lecteur de réseau Edge (roles/edgenetwork.viewer) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers list :

gcloud edge-cloud networking routers list \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.

API

Envoyez une requête GET à la méthode projects.locations.zones.routers.list :

 GET /v1/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projetcible. Google Cloud
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.
  • FILTER: expression qui limite les résultats renvoyés à des valeurs spécifiques.
  • PAGE_SIZE : nombre de résultats à renvoyer par page.
  • SORT_BY: liste de noms de champs séparés par une virgule selon lesquels les résultats renvoyés sont triés. L'ordre de tri par défaut est croissant. Pour un ordre de tri décroissant, ajoutez le préfixe ~ au champ souhaité.
  • PAGE_TOKEN: jeton reçu dans la réponse à la dernière requête de liste dans le champ nextPageToken de la réponse. Envoyez ce jeton pour recevoir une page de résultats.

Obtenir des informations sur un routeur

Pour obtenir des informations sur un routeur Distributed Cloud, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Lecteur de réseau Edge (roles/edgenetwork.viewer) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers describe :

gcloud edge-cloud networking routers describe ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeurcible.
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.

API

Envoyez une requête GET à la méthode projects.locations.zones.routers.get :

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projetcible. Google Cloud
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.
  • ROUTER_ID : ID du routeurcible.

Cette opération renvoie des informations détaillées sur la ressource, y compris son état de provisionnement :

  • PENDING: le provisionnement de la ressource n'a pas encore commencé et elle n'a pas encore été propagée dans toute la zone.
  • PROVISIONING: la ressource est en cours de provisionnement. Vous devez attendre qu'elle ait été propagée dans toute la zone.
  • RUNNING: la ressource a été provisionnée et propagée dans toute la zone. Elle est prête à être utilisée.
  • FAILED: le provisionnement de la ressource a échoué. La ressource n'a pas été propagée dans toute la zone.

Vérifier l'état opérationnel d'un routeur

Pour vérifier l'état opérationnel d'un routeur Distributed Cloud, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Lecteur de réseau Edge (roles/edgenetwork.viewer) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers get-status :

gcloud edge-cloud networking routers get-status ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeurcible.
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.

API

Envoyez une requête GET à la méthode projects.locations.zones.routers.diagnose :

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID:diagnose

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projetcible. Google Cloud
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.
  • ROUTER_ID : ID du routeurcible.

Supprimer un routeur

Pour supprimer un routeur Distributed Cloud, suivez les étapes décrites dans cette section.

Pour effectuer cette tâche, vous devez disposer du rôle Administrateur de réseau Edge (roles/edgenetwork.admin) dans votre Google Cloud projet.

gcloud

Exécutez la commande gcloud edge-cloud networking routers delete :

gcloud edge-cloud networking routers delete ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeurcible.
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.

API

Envoyez une requête DELETE à la méthode projects.locations.zones.routers.delete :

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projetcible. Google Cloud
  • REGION : région à laquelle appartient la zone Distributed Cloud connecté cible. Google Cloud
  • ZONE_NAME: nom de la zone Distributed Cloud connecté cible.
  • ROUTER_ID : ID du routeurcible.

Étape suivante