Créer un routeur Cloud pour connecter un réseau VPC à un réseau de pairs

gcloud

Si vous souhaitez utiliser les exemples de ligne de commande de ce guide, procédez comme suit :

1. Installez la dernière version de la CLI Google Cloud ou appliquez la mise à jour correspondante.
2. Définissez une région et une zone par défaut.

API

Si vous voulez utiliser les exemples d'API de ce guide, configurez l'accès aux API.

Console

1. Dans la console Trusted Cloud , accédez à la page Créer un routeur Cloud Router.

   Accéder à la page Créer un Cloud Router

2. Spécifiez les détails du routeur cloud :

• Nom : nom du routeur cloud. Ce nom est affiché dans la console Trusted Cloud et permet à Google Cloud CLI de référencer Cloud Router (par exemple, my-router).
• Description (facultatif) : description du routeur Cloud Router.
• Réseau : réseau VPC qui contient les instances à joindre (par exemple, my-network).
• Région : région dans laquelle localiser le routeur cloud, par exemple asia-east1.

• Google ASN: Any private ASN (64512-65534, 4200000000-4294967294) that you aren't already using in the on-premises network. Cloud Router requires that you use a private ASN, but your on-premises ASN can be public or private.

• Intervalle keepalive du pair BGP : intervalle entre deux messages keepalive BGP successifs envoyés au routeur pair. Cette valeur doit être un nombre entier compris entre 20 et 60 qui spécifie le nombre de secondes de l'intervalle. La valeur par défaut est de 20 secondes. Pour plus d'informations, consultez la page Gérer les timers BGP.

• Identifiant BGP : facultatif. Identifiant BGP, parfois appelé ID de routeur, qui identifie de manière unique un routeur Cloud Router dans un réseau. En cas d'omission, les routeurs Cloud Router avec des sessions BGP IPv4 utilisent l'une des adresses BGP IPv4 comme identifiant BGP et l'ajout de la première interface IPv6 à ce routeur cloud renseigne automatiquement le champ.

  Pour en savoir plus, consultez la section Configurer la plage d'identifiants BGP pour un routeur Cloud Router.

3. Facultatif : Pour spécifier des routes annoncées personnalisées, accédez à la section Routes annoncées. Pour en savoir plus, consultez Routes annoncées.
   1. Pour spécifier des Routes, sélectionnez Créer des routes personnalisées.
   2. Indiquez si vous souhaitez annoncer les sous-réseaux disponibles pour le routeur cloud. Cette option imite le comportement par défaut du routeur cloud.
   3. Pour ajouter une route annoncée, sélectionnez Ajouter une route personnalisée, puis configurez-la.
4. Pour enregistrer vos paramètres et créer un routeur cloud, cliquez sur Créer. Votre nouveau routeur cloud apparaît sur la page listant les routeurs cloud. Pour afficher ses détails et configurer une session BGP, sélectionnez-le.

gcloud

La commande gcloud compute routers create crée un routeur Cloud Router. Cloud Router est associé à un réseau VPC ou à un spoke de passerelle NCC. Une fois créé, vous ne pouvez plus modifier la région, le réseau VPC associé ni le spoke de passerelle NCC associé.

L'option --set-advertisement-groups=ALL_SUBNETS n'est valide que lorsque l'option --advertisement-mode=CUSTOM est définie. Lorsque cette option et cette valeur sont spécifiées, les annonces au niveau du routeur incluent les plages de sous-réseaux locaux en fonction du mode de routage dynamique du réseau VPC.

Pour en savoir plus, consultez Annonce de plage de sous-réseaux.

N'incluez l'indicateur --encrypted-interconnect-router que si le routeur Cloud Router gère les sessions BGP pour HA VPN sur Cloud Interconnect.

• Pour créer un routeur Cloud Router associé à une région d'un réseau VPC, utilisez la commande suivante :

  gcloud compute routers create ROUTER_NAME \
      --project=PROJECT_ID \
      --network=NETWORK \
      --region=REGION\
      --asn=ASN_NUMBER \
      [--advertisement-mode=ADVERTISEMENT_MODE] \
      [--set-advertisement-groups=ALL_SUBNETS] \
      [--set-advertisement-ranges=CUSTOM_ADVERTISED_RANGES] \
      [--bgp-identifier-range=ROUTER_IDENTIFIER_RANGE] \
      [--keepalive-interval=KEEPALIVE_TIMER] \
      [--encrypted-interconnect-router]
  

  Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeur Cloud Router

  • PROJECT_ID : ID du projet contenant le routeur cloud.

  • NETWORK : réseau VPC contenant Cloud Router

  • REGION : région contenant le routeur Cloud Router.

  • ASN_NUMBER : n'importe quel numéro ASN privé (64512-65534, 4200000000-4294967294) que vous n'utilisez pas déjà dans le réseau sur site

    Cloud Router nécessite l'utilisation d'un numéro ASN privé, mais votre numéro ASN sur site peut être public ou privé.

  • ADVERTISEMENT_MODE : spécifie le mode d'annonce au niveau du routeur.

    Les valeurs valides sont CUSTOM ou DEFAULT. Si vous omettez l'indicateur --advertisement-mode, Trusted Cloud utilise le mode d'annonce DEFAULT au niveau du routeur. Pour en savoir plus sur la signification du mode d'annonce au niveau du routeur et sur son effet sur les annonces de sessions BGP individuelles, consultez Modes d'annonce et Annonces effectives.

  • CUSTOM_ADVERTISED_RANGES : valide uniquement lorsque --advertisement-mode=CUSTOM, liste facultative de plages d'adresses IP personnalisées au format CIDR ou d'adresses IP individuelles à inclure dans les annonces au niveau du routeur

    Les adresses IPv4 individuelles sont interprétées comme un CIDR avec un masque de sous-réseau /32, et les adresses IPv6 individuelles sont interprétées comme un CIDR avec un masque de sous-réseau /128. Pour en savoir plus sur le nombre maximal d'annonces de routage personnalisées, consultez la section Limites.

  • ROUTER_IDENTIFIER_RANGE : plage d'adresses IPv4 facultative qui sert d'identifiant unique pour le routeur Cloud Router.

    Pour en savoir plus, consultez Configurer la plage d'identifiants BGP.

  • KEEPALIVE_TIMER : durée facultative, en secondes, qui définit le délai de vie BGP.

    Les valeurs valides sont comprises entre 20 et 60, inclus. Si vous omettez l'indicateur --keepalive-interval, Cloud Router utilise un délai de vie BGP de 20 secondes. Pour en savoir plus, consultez la section Timer keepalive.

• Pour créer un routeur Cloud Router associé à un spoke de passerelle NCC, utilisez la commande suivante.

  Utilisez l'indicateur --advertisement-mode=CUSTOM pour définir le mode d'annonce au niveau du routeur sur CUSTOM afin de pouvoir spécifier des annonces de routage personnalisées au niveau du routeur.

  Pour en savoir plus sur l'effet du mode d'annonce au niveau du routeur sur les annonces de sessions BGP individuelles, consultez Annonces effectives.

  gcloud compute routers create ROUTER_NAME \
      --project=PROJECT_ID \
      --ncc-gateway=NCC_GATEWAY_URI \
      --region=REGION\
      --asn=ASN_NUMBER \
      --advertisement-mode=CUSTOM \
      --set-advertisement-ranges=CUSTOM_ADVERTISED_RANGES \
      [--bgp-identifier-range=ROUTER_IDENTIFIER_RANGE] \
      [--keepalive-interval=KEEPALIVE_TIMER] \
  

  Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeur Cloud Router

  • PROJECT_ID : ID du projet contenant le routeur cloud.

  • NCC_GATEWAY_URI : URI complet de la passerelle NCC associée au routeur. Le format de l'URI suit le modèle suivant : https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/GATEWAY_SPOKE_NAME

  • REGION : région contenant le routeur Cloud Router.

  • ASN_NUMBER : n'importe quel numéro ASN privé (64512-65534, 4200000000-4294967294) que vous n'utilisez pas déjà dans le réseau sur site

    Cloud Router nécessite l'utilisation d'un numéro ASN privé, mais votre numéro ASN sur site peut être public ou privé.

  • --advertisement-mode=CUSTOM : définit le mode d'annonce au niveau du routeur sur CUSTOM afin que vous puissiez spécifier des annonces de routage personnalisées au niveau du routeur.

    Pour en savoir plus sur l'effet du mode d'annonce au niveau du routeur sur les annonces de sessions BGP individuelles, consultez Annonces effectives.

  • CUSTOM_ADVERTISED_RANGES : liste des plages d'adresses IP personnalisées au format CIDR ou des adresses IP individuelles à inclure dans les annonces au niveau du routeur

    Les adresses IPv4 individuelles sont interprétées comme un CIDR avec un masque de sous-réseau /32, et les adresses IPv6 individuelles sont interprétées comme un CIDR avec un masque de sous-réseau /128. Pour en savoir plus sur le nombre maximal d'annonces de routage personnalisées, consultez la section Limites.

  • ROUTER_IDENTIFIER_RANGE : plage d'adresses IPv4 facultative qui sert d'identifiant unique pour le routeur Cloud Router

    Pour en savoir plus, consultez Configurer la plage d'identifiants BGP.

  • KEEPALIVE_TIMER : durée facultative, en secondes, qui définit le délai de vie BGP.

    Les valeurs valides sont comprises entre 20 et 60, inclus. Si vous omettez l'indicateur --keepalive-interval, Cloud Router utilise un délai de vie BGP de 20 secondes. Pour en savoir plus, consultez la section Timer keepalive.

Terraform

Utilisez le module TerraformTrusted Cloud pour Cloud Router.

module "cloud_router" {
  source  = "terraform-google-modules/cloud-router/google"
  version = "~> 7.0"

  name   = "my-router"
  region = "us-central1"

  bgp = {
    # The ASN (16550, 64512 - 65534, 4200000000 - 4294967294) can be any private ASN
    # not already used as a peer ASN in the same region and network or 16550 for Partner Interconnect.
    asn = "65001"
  }

  project = var.project_id
  network = module.vpc.network_name
}

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez Commandes Terraform de base.

API

La méthode routers.insert crée un routeur Cloud Router. Cloud Router est associé à un réseau VPC ou à un spoke de passerelle NCC. Une fois créé, vous ne pouvez plus modifier la région, le réseau VPC associé ni le spoke de passerelle NCC associé.

L'indicateur "advertisedGroups": [ALL_SUBNETS] n'est valide que lorsque bgp.advertiseMode: CUSTOM. Lorsque bgp.advertisedGroups: [ALL_SUBNETS], les annonces au niveau du routeur incluent les plages de sous-réseaux locaux en fonction du mode de routage dynamique du réseau VPC. Pour en savoir plus, consultez Annonce de plage de sous-réseaux.

L'indicateur encryptedInterconnectRouter est un paramètre booléen qui indique si le routeur Cloud Router gère les sessions BGP pour le VPN haute disponibilité sur Cloud Interconnect.

• Pour créer un routeur Cloud Router associé à une région d'un réseau VPC, utilisez la requête suivante :

       POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers
       {
         "name": "ROUTER_NAME",
         "network": "NETWORK",
         "encryptedInterconnectRouter": True|False,
         "bgp": {
           "asn": "ASN_NUMBER",
           "advertiseMode": "ADVERTISEMENT_MODE",
           "advertisedGroups": [ALL_SUBNETS],
           "advertisedIpRanges": [
              {
                 "range": CUSTOM_ADVERTISED_RANGE,
                 "description": CUSTOM_ADVERTISED_RANGE_DESCRIPTION
              }, ...
           ],
           "identifierRange": ROUTER_IDENTIFIER_RANGE,
           "keepaliveInterval": KEEPALIVE_TIMER
         }
       }
  

  Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeur Cloud Router

  • PROJECT_ID : ID du projet contenant le routeur cloud.

  • NETWORK : réseau VPC contenant Cloud Router

  • REGION : région contenant le routeur Cloud Router.

  • ASN_NUMBER : n'importe quel numéro ASN privé (64512-65534, 4200000000-4294967294) que vous n'utilisez pas déjà dans le réseau sur site

    Cloud Router nécessite l'utilisation d'un numéro ASN privé, mais votre numéro ASN sur site peut être public ou privé.

  • ADVERTISEMENT_MODE : spécifie le mode d'annonce au niveau du routeur.

    Les valeurs valides sont CUSTOM ou DEFAULT. Si vous omettez bgp.advertiseMode, Trusted Cloud utilise le mode d'annonce DEFAULT au niveau du routeur. Pour en savoir plus sur la signification du mode d'annonce au niveau du routeur et sur son effet sur les annonces de sessions BGP individuelles, consultez Modes d'annonce et Annonces effectives.

  • CUSTOM_ADVERTISED_RANGE et CUSTOM_ADVERTISED_RANGE_DESCRIPTION : clés d'un dictionnaire qui spécifient une annonce de routage personnalisée au niveau du routeur

    bgp.advertisedIpRanges est la liste contenant chaque dictionnaire d'annonces de routes personnalisées. Si vous spécifiez bgp.advertisedIpRanges, vous devez également spécifier bgp.advertiseMode: CUSTOM. Chaque CUSTOM_ADVERTISED_RANGE est une plage d'adresses IP au format CIDR ou une adresse IP individuelle. Les adresses IPv4 individuelles sont interprétées comme un CIDR avec un masque de sous-réseau /32, et les adresses IPv6 individuelles sont interprétées comme un CIDR avec un masque de sous-réseau /128. Pour en savoir plus sur le nombre maximal d'annonces de routage personnalisées, consultez la section Limites. Chaque CUSTOM_ADVERTISED_RANGE_DESCRIPTION est une chaîne permettant de décrire l'annonce.

  • ROUTER_IDENTIFIER_RANGE : définit une plage d'adresses IPv4 qui sert d'identifiant unique pour Cloud Router.

    Pour en savoir plus, consultez Configurer la plage d'identifiants BGP.

  • KEEPALIVE_TIMER : durée facultative, en secondes, qui définit le délai de vie BGP.

    Les valeurs valides sont comprises entre 20 et 60, inclus. Si vous omettez bgp.keepaliveInterval, Cloud Router utilise un délai de keepalive BGP de 20 secondes. Pour en savoir plus, consultez la section Timer keepalive.

  • encryptedInterconnectRouter : paramètre booléen indiquant si le routeur Cloud Router gère les sessions BGP pour le VPN haute disponibilité sur Cloud Interconnect

• Pour créer un routeur Cloud Router associé à un spoke de passerelle NCC, utilisez la requête suivante.

  L'indicateur bgp.advertiseMode: CUSTOM définit le mode d'annonce au niveau du routeur sur CUSTOM afin que vous puissiez spécifier des annonces de routage personnalisées au niveau du routeur. Pour en savoir plus sur l'effet du mode d'annonce au niveau du routeur sur les annonces de sessions BGP individuelles, consultez Annonces effectives.

       POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers
       {
         "name": "ROUTER_NAME",
         "ncc_gateway": "NCC_GATEWAY_URI",
         "bgp": {
           "asn": "ASN_NUMBER",
           "advertiseMode": CUSTOM,
           "advertisedIpRanges": [
              {
                 "range": CUSTOM_ADVERTISED_RANGE,
                 "description": CUSTOM_ADVERTISED_RANGE_DESCRIPTION
              }, ...
           ],
           "identifierRange": ROUTER_IDENTIFIER_RANGE,
           "keepaliveInterval": KEEPALIVE_TIMER
         }
       }
  

  Remplacez les éléments suivants :

  • ROUTER_NAME : nom du routeur Cloud Router

  • PROJECT_ID : ID du projet contenant le routeur cloud.

  • NCC_GATEWAY_URI : URI complet de la passerelle NCC associée au routeur. Le format de l'URI suit le modèle suivant : https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/GATEWAY_SPOKE_NAME

  • REGION : région contenant le routeur Cloud Router.

  • ASN_NUMBER : n'importe quel numéro ASN privé (64512-65534, 4200000000-4294967294) que vous n'utilisez pas déjà dans le réseau sur site

    Cloud Router nécessite l'utilisation d'un numéro ASN privé, mais votre numéro ASN sur site peut être public ou privé.

  • CUSTOM_ADVERTISED_RANGE et CUSTOM_ADVERTISED_RANGE_DESCRIPTION : clés d'un dictionnaire qui spécifient une annonce de routage personnalisée au niveau du routeur

    bgp.advertisedIpRanges est la liste contenant chaque dictionnaire d'annonces de routes personnalisées. Si vous spécifiez bgp.advertisedIpRanges, vous devez également spécifier bgp.advertiseMode: CUSTOM. Chaque CUSTOM_ADVERTISED_RANGE correspond à une plage d'adresses IP au format CIDR ou à une adresse IP individuelle. Les adresses IPv4 individuelles sont interprétées comme un CIDR avec un masque de sous-réseau /32, et les adresses IPv6 individuelles sont interprétées comme un CIDR avec un masque de sous-réseau /128. Pour en savoir plus sur le nombre maximal d'annonces de routage personnalisées, consultez Limites. Chaque CUSTOM_ADVERTISED_RANGE_DESCRIPTION est une chaîne permettant de décrire l'annonce.

  • ROUTER_IDENTIFIER_RANGE : définit une plage d'adresses IPv4 qui sert d'identifiant unique pour le routeur Cloud Router.

    Pour en savoir plus, consultez Configurer la plage d'identifiants BGP.

  • KEEPALIVE_TIMER : durée facultative, en secondes, qui définit le délai de vie BGP.

    Les valeurs valides sont comprises entre 20 et 60, inclus. Si vous omettez bgp.keepaliveInterval, Cloud Router utilise un délai de keepalive BGP de 20 secondes. Pour en savoir plus, consultez la section Timer keepalive.