Créer et gérer des routeurs

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

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

Pour en savoir plus sur les routeurs Distributed Cloud, consultez Fonctionnement de Distributed Cloud.

Tenez bien compte des éléments suivants :

  • Vous ne pouvez créer qu'un seul routeur par réseau Distributed Cloud.

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

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éseaux Edge (roles/edgenetwork.admin) dans votre projet Google Cloud .

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 Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.
  • ASN : numéro ASN (Autonomous System Number) de ce routeur. Vous pouvez spécifier une valeur de deux ou quatre octets. Compatible avec les valeurs ASN publiques et privé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 projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud 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 ASN (Autonomous System Number) de ce routeur. Vous pouvez spécifier une valeur de deux ou quatre octets. Compatible avec les valeurs ASN publiques et privé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 réseau Distributed Cloud qui correspond au type de session d'appairage.

Établir une session d'appairage northbound

Pour établir une session d'appairage northbound sur un routeur avec une pièce jointe d'interconnexion, suivez les étapes décrites dans cette section. La pièce jointe d'interconnexion cible doit être associée au routeur cible.

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

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 routeur cible.
  • INTERFACE_NAME : nom descriptif de cette interface.
  • ATTACHMENT_NAME : nom du rattachement d'interconnexion cible dans le routeur cible.
  • INTERCONNECT_ADDRESS : adresse IPv4 de l'interconnexion sur laquelle la pièce jointe d'interconnexion cible est configurée.
  • IP_MASK_LENGTH : longueur du masque pour l'adresse IP d'interconnexion spécifiée.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.

Établir une session d'appairage vers le sud

Pour établir une session d'appairage southbound 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éseaux Edge (roles/edgenetwork.admin) dans votre projet Google Cloud .

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 routeur cible.
  • INTERFACE_NAME : nom descriptif de cette interface.
  • SUBNETWORK_NAME : nom du sous-réseau cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.

Établir une session d'appairage de rebouclage

Pour établir une session d'appairage en boucle 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éseaux Edge (roles/edgenetwork.admin) dans votre projet Google Cloud .

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 routeur cible.
  • 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 Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.

Arrêter une session d'appairage BGP

Pour mettre fin à une session d'appairage BGP entre un routeur et une pièce jointe 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éseaux Edge (roles/edgenetwork.admin) dans votre projet Google Cloud .

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 routeur cible.
  • INTERFACE_NAME : nom descriptif de cette interface.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud 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 de peering 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 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éseaux Edge (roles/edgenetwork.admin) dans votre projet Google Cloud .

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_IP_RANGE \
    --interface=INTERFACE_NAME \                                                       \
    --location=REGION \
    --zone=ZONE_NAME

Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeur cible.
  • PEER_NAME : nom descriptif de ce pair.
  • PEER_ASN : numéro ASN (Autonomous System Number) de ce pair. Vous pouvez spécifier une valeur de deux ou quatre octets. Compatible avec les valeurs ASN publiques et privées.
  • PEER_IP_RANGE : plage CIDR IPv4 pour 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és.
  • INTERFACE_NAME : nom de l'interface correspondant à la session BGP cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud 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éseaux Edge (roles/edgenetwork.admin) dans votre projet Google Cloud .

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 routeur cible.
  • PEER_NAME : nom du pair cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.

Obtenir la liste des routeurs

Pour lister les routeurs provisionnés dans une zone 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 projet Google Cloud .

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 Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud 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 projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud 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 décroissant, ajoutez le préfixe ~ au champ souhaité.
  • PAGE_TOKEN : jeton reçu en 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 de cette section.

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

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 routeur cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud 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 projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.
  • ROUTER_ID : ID du routeur cible.

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

  • 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 soit propagée dans toute la zone.
  • RUNNING : la ressource a été provisionnée et propagée avec succès dans toute la zone. Elle est prête à être utilisée.
  • FAILED : le provisionnement de la ressource n'a pas abouti. La ressource n'a pas été propagée dans 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 projet Google Cloud .

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 routeur cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud 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 projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.
  • ROUTER_ID : ID du routeur cible.

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éseaux Edge (roles/edgenetwork.admin) dans votre projet Google Cloud .

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 routeur cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud 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 projet Google Cloud cible.
  • REGION : région Google Cloud à laquelle appartient la zone Distributed Cloud cible.
  • ZONE_NAME : nom de la zone Distributed Cloud cible.
  • ROUTER_ID : ID du routeur cible.

Étapes suivantes