Premiers pas avec OVHcloud Public Cloud Gateway

Créez et gérez vos Gateways Public Cloud depuis la console OVHcloud, l'API, ovhcloud-cli ou Terraform

Objectif

Une Gateway OVHcloud fournit une connectivité sortante sécurisée (SNAT) pour les instances d'un sous-réseau privé. Elle est également requise sur ce sous-réseau pour exposer publiquement ces ressources privées via les Floating IPs.

Ce guide vous explique comment créer, lister, modifier et supprimer une Gateway Public Cloud depuis la console OVHcloud, l'API OVHcloud, ovhcloud-cli ou Terraform.

Prérequis

Posséder un projet Public Cloud dans votre compte OVHcloud
Disposer d'un réseau privé avec au moins un sous-réseau dans la région cible (voir Configurer vRack pour le Public Cloud)
Pour l'API OVHcloud : des identifiants API OVHcloud (Premiers pas avec les API OVHcloud)
Pour ovhcloud-cli : ovhcloud-cli installé et configuré avec vos identifiants
Pour Terraform : Terraform installé et le provider OVH configuré (Comment utiliser Terraform avec OVHcloud)

Accès à la console OVHcloud

Lien direct :
Pour accéder à vos services : Public Cloud > Sélectionnez votre projet > Réseau > Gateway

En pratique

Modèles de Gateway

Avant de créer une Gateway, choisissez le modèle qui correspond à vos besoins en bande passante :

Info

Veuillez noter qu'actuellement, la taille 2XL n'est pas disponible dans les régions de Mumbai, Singapour et Sydney.

Modèle	Bande passante
S	jusqu'à 200 Mbps
M	jusqu'à 500 Mbps
L	jusqu'à 2 Gbps
XL	jusqu'à 4 Gbps
2XL	jusqu'à 8 Gbps

Créer une Gateway

Console OVHcloud

API OVHcloud

ovhcloud-cli

Terraform

Depuis votre projet Public Cloud, cliquez sur Gateway dans le menu de gauche sous Réseau, puis cliquez sur Créer une Gateway.

Nommez la Gateway. Renseignez le Nom de la gateway.
Sélectionnez une région. Dans Sélectionner une région, choisissez la région dans laquelle vos instances privées sont déployées.
Sélectionnez une taille. Dans Sélectionner la taille, choisissez le modèle de Gateway en fonction de vos besoins en bande passante (voir le tableau ci-dessus).
Associez un réseau. Dans Attacher à un réseau privé spécifique, sélectionnez un réseau privé existant, ou cliquez sur Créer un réseau privé pour en créer un directement.
Cliquez sur Créer une Gateway pour confirmer. Le provisionnement de la Gateway prend quelques minutes.

Une fois créée, la Gateway apparaît dans la section Gateway, et le réseau privé associé est visible sous Private Network.

Info

Seuls les réseaux privés mono-région sont pris en charge par la Gateway.

Rendez-vous sur l' et utilisez l'appel suivant pour créer une Gateway ainsi qu'un nouveau réseau privé et un sous-réseau en une seule opération :

POST/cloud/project/{serviceName}/region/{regionName}/gateway

Champ	Description
`serviceName`	L'identifiant de votre projet Public Cloud
`regionName`	La région cible (ex. : `GRA9`)
`model`	Taille de la Gateway : `s`, `m`, `l`, `xl`, `2xl`, `3xl`
`name`	Nom de votre Gateway
`network.name`	Nom du nouveau réseau privé
`network.cidr`	CIDR du sous-réseau (ex. : `192.168.1.0/24`)
`network.enableDhcp`	`true` pour activer le DHCP sur le sous-réseau
`network.ipVersion`	`4` (IPv6 non encore disponible)
`network.vlanId`	Identifiant VLAN (2–4000), ou vide pour une attribution automatique

L'appel retourne un objet cloud.Operation. Pour associer une Gateway à un sous-réseau existant, utilisez :

POST/cloud/project/{serviceName}/region/{regionName}/network/{networkId}/subnet/{subnetId}/gateway

Pour récupérer l'identifiant de votre projet :

GET/cloud/project

Utilisez ovhcloud cloud network gateway create avec la région cible et l'option --wait pour attendre la fin du provisionnement.

Créer une Gateway dans un réseau privé existant :

ovhcloud cloud network gateway create <region> \
  --cloud-project <project_id> \
  --name my-gateway \
  --model s \
  --network-id <network_id> \
  --subnet-id <subnet_id> \
  --wait

Créer une Gateway avec un nouveau réseau privé :

ovhcloud cloud network gateway create <region> \
  --cloud-project <project_id> \
  --name my-gateway \
  --model s \
  --network-name my-network \
  --subnet-cidr 192.168.1.0/24 \
  --subnet-enable-dhcp \
  --wait

Modèles disponibles : s, m, l, xl, 2xl, 3xl.

Créez un fichier de configuration Terraform (ex. : gateway.tf) avec les ressources suivantes :

resource "ovh_cloud_project_network_private" "mypriv" {
  service_name = "<project_id>"
  vlan_id      = "0"
  name         = "my-network"
  regions      = ["GRA9"]
}

resource "ovh_cloud_project_network_private_subnet" "myprivsub" {
  service_name = ovh_cloud_project_network_private.mypriv.service_name
  network_id   = ovh_cloud_project_network_private.mypriv.id
  region       = "GRA9"
  start        = "10.0.0.2"
  end          = "10.0.255.254"
  network      = "10.0.0.0/16"
  dhcp         = true
}

resource "ovh_cloud_project_gateway" "gateway" {
  service_name = ovh_cloud_project_network_private.mypriv.service_name
  name         = "my-gateway"
  model        = "s"
  region       = ovh_cloud_project_network_private_subnet.myprivsub.region
  network_id   = tolist(ovh_cloud_project_network_private.mypriv.regions_attributes[*].openstackid)[0]
  subnet_id    = ovh_cloud_project_network_private_subnet.myprivsub.id
}

Appliquez la configuration :

terraform init
terraform apply

Info

Remplacez GRA9 par votre région cible et <project_id> par l'identifiant de votre projet Public Cloud.

Lister vos Gateways

Console OVHcloud

API OVHcloud

ovhcloud-cli

Depuis votre projet Public Cloud, cliquez sur Gateway dans le menu de gauche sous Réseau.

La page liste toutes les Gateways de votre projet avec leur région, modèle, statut et réseau associé.

GET/cloud/project/{serviceName}/region/{regionName}/gateway

Champ	Description
`serviceName`	L'identifiant de votre projet Public Cloud
`regionName`	La région cible
`subnetId`	(Optionnel) Filtrer par identifiant de sous-réseau associé
`withSubnets`	(Optionnel) Inclure les détails des sous-réseaux dans la réponse

Modifier une Gateway

Vous pouvez modifier le nom ou le modèle (taille) d'une Gateway existante.

Console OVHcloud

API OVHcloud

ovhcloud-cli

Terraform

Pour modifier le modèle (taille), cliquez sur le menu ... à côté de votre Gateway dans la liste Gateway, puis sélectionnez Modifier la taille. Sélectionnez la nouvelle taille, puis cliquez sur Modifier la taille.

Pour modifier le nom, cliquez sur le nom de votre Gateway pour ouvrir sa page, cliquez sur l'icône Modifier le nom à côté du nom, saisissez le nouveau nom, puis confirmez.

Supprimer une Gateway

Warning

La suppression d'une Gateway est irréversible. Les instances qui l'utilisent pour leur connectivité sortante perdront leur accès à Internet.

Console OVHcloud

API OVHcloud

ovhcloud-cli

Terraform

Depuis la liste Gateway, cliquez sur le menu ... à côté de votre Gateway, puis sélectionnez Supprimer et confirmez.

Supprimez le bloc de ressource ovh_cloud_project_gateway de votre fichier de configuration, puis appliquez :

terraform apply

Pour supprimer toutes les ressources de la configuration :

terraform destroy

Aller plus loin

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Échangez avec notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?