Utiliser une passerelle personnalisée sur un cluster OVHcloud Managed Kubernetes
Découvrez comment utiliser une passerelle personnalisée sur OVHcloud Managed Kubernetes, avec votre routeur ou pare-feu (plan Standard) ou une passerelle vRack (plan Free)
Objectif
Une passerelle personnalisée vous permet de contrôler la façon dont les nœuds de votre cluster OVHcloud Managed Kubernetes accèdent à Internet : par exemple pour disposer d'une seule adresse IP de sortie à autoriser chez vos partenaires, ou pour faire passer tout le trafic de vos nœuds par votre propre pare-feu afin de l'inspecter, de le filtrer et de le journaliser (architecture hub-and-spoke).
La méthode dépend du plan de votre cluster :
Sur tout nouveau cluster Standard, le trafic entre les nœuds et le control plane Kubernetes passe par un chemin privé opéré par OVHcloud. Le fonctionnement du cluster ne dépend pas de votre passerelle : une modification ou une panne de votre routeur n'affecte pas la communication entre les nœuds et le control plane.
- Utiliser votre propre routeur ou pare-feu (plan Standard)
- Router la sortie via une passerelle dans votre vRack (plan Free)
Accès à la console OVHcloud
- Lien direct :
- Pour accéder à vos services :
Public Cloud> Sélectionnez votre projet >Conteneurs>Managed Kubernetes Service
Utiliser votre propre routeur ou pare-feu (plan Standard)
Fonctionnement
Avec le plan Standard, les nœuds n'ont pas d'IP publique par défaut : ils accèdent à Internet via une passerelle managée OVHcloud, ou via des Floating IP définies au niveau du pool de nœuds.
Les clusters Standard créés depuis le 13 octobre 2026, quelle que soit leur version de Kubernetes, peuvent à la place utiliser votre propre routeur ou pare-feu comme passerelle par défaut des nœuds. C'est l'architecture hub-and-spoke classique : votre appliance de sécurité est le hub, et le cluster est l'un des spokes. Votre appliance est la passerelle annoncée sur le sous-réseau des nœuds de votre réseau privé : le trafic sortant des nœuds passe par elle (sauf le trafic vers le control plane et les images système du service), et aucune passerelle managée OVHcloud n'est nécessaire.
Ce que cela implique pour le cluster :
- Votre appliance porte le trafic sortant des workloads : accès à Internet, aux autres réseaux, aux ressources on-premises. Les pods sortent avec l'adresse privée de leur nœud : vos règles de pare-feu voient donc des adresses de nœuds, et non des adresses de pods.
- Elle n'est pas sur le chemin du cluster lui-même : les nœuds joignent le control plane Kubernetes via un chemin privé opéré par OVHcloud, et les images système du service ne passent pas par votre appliance. Si votre appliance est indisponible, le cluster continue de fonctionner, mais vos workloads qui dépendent d'elle, par exemple pour accéder à Internet ou à d'autres ressources externes, sont affectés.
- L'exposition publique des nœuds et des workloads est désactivée : aucune Floating IP ne peut être attachée aux nœuds ni aux load balancers, et aucun Load Balancer public ne peut être créé. L'accès entrant à vos applications passe par vos propres équipements.
Avec le plan Standard, defaultVrackGateway et privateNetworkRoutingAsDefault ne sont pas utilisés : la passerelle des nœuds est celle configurée sur le sous-réseau des nœuds.
Prérequis
Côté Kubernetes :
- Disposer d'un projet Public Cloud dans votre compte OVHcloud.
- Disposer d'un cluster du plan Standard créé depuis le 13 octobre 2026, avec les options décrites ci-dessous.
Côté réseau, quelle que soit votre appliance (appliance virtuelle sur des instances Public Cloud, serveur dédié ou équipement on-premises relié à votre vRack) :
- Disposer d'un réseau privé (vRack) avec un sous-réseau pour les nœuds, dans la région du cluster.
- Le sous-réseau annonce une passerelle par défaut (DHCP option 3), et cette adresse de passerelle est portée par votre appliance. Avec la console OVHcloud ou l'API OVHcloud, le sous-réseau annonce sa première adresse : cochez
Annoncer la première adresse d'un CIDR donné comme passerelle par défaut (DHCP option 3), ou définisseznoGatewayàfalse. Avec l'API OpenStack, vous pouvez choisir une autre adresse. - Le DHCP est activé sur le sous-réseau (recommandé), et sa plage d'allocation n'inclut pas l'adresse de la passerelle.
- Aucune passerelle managée OVHcloud sur ce sous-réseau.
- Votre appliance route le trafic sortant des nœuds et autorise au minimum le DNS (port 53, TCP et UDP), ainsi que l'accès à Internet dont vos workloads ont besoin, par exemple pour récupérer des images depuis des registres de conteneurs publics.
Recommandations :
- Rendez la passerelle hautement disponible, par exemple avec deux appliances qui partagent l'adresse de passerelle sous forme d'IP virtuelle (VRRP ou CARP) : une appliance unique est un point de défaillance unique pour l'accès externe de vos workloads.
- Si votre appliance fonctionne sur des instances Public Cloud, l'adresse de passerelle doit être réservée par un port de votre appliance, et la sécurité de port doit être désactivée sur ses interfaces pour qu'elle puisse acheminer un trafic qui ne lui est pas destiné. Ces réglages sont disponibles via l'API OpenStack.
La conception du hub (choix de l'appliance, haute disponibilité, règles de filtrage et de routage) dépend de votre environnement. Pour mettre en place la partie réseau, suivez le guide « Landing zone hub and spoke sur OVHcloud Public Cloud ». L'appliance peut aussi se trouver dans un réseau hub distinct : la passerelle annoncée sur le sous-réseau des nœuds est alors un routeur OpenStack, qui achemine le trafic vers ce hub. Si vous avez besoin d'un accompagnement pour la concevoir ou la déployer, contactez votre commercial ou nos équipes Professional Services.
Options réseau du cluster
Côté Managed Kubernetes, deux attributs du cluster contrôlent cette configuration. Tous deux sont optionnels et valent false par défaut ; pour utiliser votre propre routeur, définissez-les tous deux à true.
Ces attributs ne peuvent être définis qu'à la création du cluster et ne sont plus modifiables ensuite.
Lorsque disablePublicNetworking vaut true :
- aucune Floating IP ne peut être attachée aux nœuds ni aux load balancers ;
- les Services de type
LoadBalancerne peuvent pas être exposés via un Load Balancer public.
Si vous devez exposer des applications sur Internet depuis ce cluster, conservez la configuration par défaut.
Cette option ne concerne pas l'API server Kubernetes, qui reste accessible publiquement avec vos restrictions d'IP.
Si la configuration n'est pas valide, la création du cluster est refusée :
Créer le cluster
La prise en charge de ces options dans la console OVHcloud est en cours. En attendant, utilisez l'API OVHcloud ou Terraform.
Ajouter un pool de nœuds
Les Floating IP ne peuvent pas être attachées aux nœuds de ce cluster : ne les activez pas sur le pool de nœuds. Dans une région à plusieurs zones de disponibilité, comme EU-WEST-PAR, choisissez la zone du pool de nœuds.
Ajoutez un pool de nœuds depuis l'onglet Pools de nœuds de votre cluster en suivant le guide « Gérer les nœuds et les pools de nœuds d'un cluster OVHcloud Managed Kubernetes ».
Vérifier la configuration
Vérifiez la configuration du cluster avec l'appel API suivant :
La réponse contient "disablePublicNetworking": true et "privateNetworkConfiguration": { "useUserGateway": true }.
Une fois le pool de nœuds à l'état READY, récupérez le fichier kubeconfig de votre cluster (consultez la section « Connexion au cluster » du guide « Créer un cluster » ; avec Terraform, utilisez l'output kubeconfig) et lancez un Pod de test qui affiche son IP de sortie :
La commande doit renvoyer l'adresse IP publique que votre routeur ou pare-feu utilise pour le trafic sortant.
Pour un cluster existant qui ne peut pas être recréé, nos équipes peuvent étudier au cas par cas une migration manuelle vers cette configuration. Contactez votre commercial.
Router la sortie via une passerelle dans votre vRack (plan Free)
Ce tutoriel s'applique aux clusters du plan Free.
Dans ce tutoriel, nous allons utiliser une passerelle personnalisée déployée dans le vRack avec un cluster Managed Kubernetes.
Pourquoi ?
Par défaut, dans un cluster Kubernetes, les pods que vous déployez utilisent l'IP de sortie du nœud. Nous avons donc autant d'IP de sortie que de nœuds. Cela peut poser problème lorsque vous devez gérer une liste d'autorisation et que votre cluster utilise l'autoscaling (création et suppression de nœuds à la volée).
Une solution consiste à utiliser une passerelle personnalisée, qui vous permet de disposer d'une seule IP de sortie (votre passerelle).
Vous allez :
- créer un réseau privé
- créer des sous-réseaux
- créer un routeur OpenStack (dans chaque région) et le relier au réseau du fournisseur externe ainsi qu'aux sous-réseaux
- créer un cluster OVHcloud Managed Kubernetes avec la passerelle privée
- tester l'IP de sortie du pod
À la fin de ce tutoriel, vous devriez obtenir le flux suivant :

Dans ce tutoriel, nous vous guidons pour créer le réseau privé dans deux régions, mais vous pouvez n'en utiliser qu'une seule si vous le souhaitez, par exemple GRA9.
Prérequis
- Disposer d'un projet Public Cloud dans votre compte OVHcloud.
- Avoir installé la CLI de l'API OpenStack.
- Avoir installé la CLI OVHcloud et l'avoir configurée avec vos identifiants de l'API OVHcloud.
- Être familiarisé avec l'API OVHcloud.
- Être familiarisé avec Terraform si vous souhaitez l'utiliser.
- Avoir installé l'outil d'analyse JSON jq.
Initialisation
Dans ce tutoriel, vous utilisez la CLI OVHcloud pour créer le réseau privé, les sous-réseaux et le cluster Kubernetes, et la CLI OpenStack pour créer les routeurs et les routes des sous-réseaux.
Configurez la CLI OVHcloud avec vos identifiants de l'API OVHcloud en suivant la documentation de la CLI OVHcloud.
Pour gérer OpenStack, créez un dossier utils dans votre environnement/machine locale, puis créez-y le fichier utils/openrc, ou téléchargez-le depuis votre fournisseur OpenStack. Il doit ressembler à ceci :
Chargez les variables :
La variable OS_TENANT_ID contient l'ID de votre projet Public Cloud : les commandes de la CLI OVHcloud de ce tutoriel l'utilisent avec l'option --cloud-project.
Créer le réseau privé
Important : nous supposons que votre projet PCI est ajouté à votre vRack.
Pour ce tutoriel, nous utilisons les deux régions GRA9 et GRA11.
Créez le réseau privé nommé demo-pvnw, avec l'ID de VLAN 20, dans les régions GRA9 et GRA11 :
Avec la CLI OVHcloud, un réseau privé est créé dans une seule région : créez un réseau par région, avec le même ID de VLAN, et récupérez leurs ID (pvnwGRA9Id et pvnwGRA11Id).
Créer des sous-réseaux
Pour ce tutoriel, nous divisons un sous-réseau /24 pour obtenir deux sous-réseaux /25.
Réf. : https://www.davidc.net/sites/default/subnets/subnets.html
Créez les sous-réseaux, et récupérez leurs ID (subnGRA9 et subnGRA11) :
Il n'est pas possible d'ajouter des routes aux sous-réseaux avec la CLI OVHcloud, il faut donc utiliser la CLI OpenStack.
Routeur OpenStack
Créer les routeurs
Nous avons la possibilité de créer des routeurs virtuels OpenStack. Pour cela, nous devons utiliser la CLI OpenStack. Créez les routeurs et récupérez leurs ID (rtrGRA9Id et rtrGRA11Id) :
Vous devriez obtenir un résultat de ce type :
Relier le routeur au réseau du fournisseur externe
Tout d'abord, récupérez l'ID du réseau externe régional (extNwGRA9Id et extNwGRA11Id), puis reliez-le au routeur :
Vous devriez obtenir un résultat de ce type :
Vous pouvez maintenant afficher les informations de votre nouveau routeur virtuel sur GRA9 afin d'afficher son IP :
Comme vous pouvez le voir, dans cet exemple, l'IP de la passerelle sera 141.94.209.244.
Relier le routeur au sous-réseau
Faites de même avec les sous-réseaux régionaux :
Créer un cluster Kubernetes avec passerelle privée
Le réseau est maintenant prêt. Créez un cluster OVHcloud Managed Kubernetes en spécifiant l'utilisation de la passerelle définie sur chaque sous-réseau.
Remarque : jusqu'à la fin de ce tutoriel, nous n'utilisons que la région
GRA9, mais vous pouvez répéter exactement les mêmes étapes pour créer un cluster dans la régionGRA11.
Dans ce guide, nous avons défini la version 1.34 pour le cluster Kubernetes, mais vous pouvez utiliser une autre version prise en charge.
Créez le cluster OVHcloud Managed Kubernetes dans GRA9, sur le réseau privé GRA9 (pvnwGRA9Id), et récupérez l'ID du cluster (kubeId) :
Créez un fichier data-kube.json avec les paramètres du cluster et de son pool de nœuds :
Puis créez le cluster avec l'ID du réseau privé GRA9 :
Attendez maintenant que votre cluster OVHcloud Managed Kubernetes soit à l'état READY.
Pour cela, vous pouvez vérifier son statut dans la console OVHcloud :
Cliquez sur Managed Kubernetes Service sous Conteneurs dans le menu de gauche de votre projet Public Cloud.
Cliquez sur votre cluster demo : son onglet Réseau indique qu'il est attaché au réseau demo-pvnw.
Son statut est affiché dans l'onglet Vue d'ensemble.
Lorsque le statut de votre cluster est OK, vous pouvez passer à la section suivante.
Récupérer le fichier Kubeconfig
Pour continuer avec le cluster Kubernetes nouvellement créé, vous devez récupérer le fichier Kubeconfig.
Pour utiliser ce fichier kubeconfig et accéder à votre cluster, vous pouvez suivre notre tutoriel configurer kubectl, ou simplement ajouter l'option --kubeconfig dans vos commandes kubectl.
Test
Listez les nœuds actifs de votre cluster :
Vous devriez obtenir un résultat de ce type :
Testez maintenant le cluster en exécutant un conteneur simple qui demande son adresse IP publiée.
Vous devriez obtenir un résultat de ce type :
L'adresse IP de notre pod est bien celle de notre passerelle !
Suppression (nettoyage)
Pour supprimer les ressources créées, suivez les instructions ci-dessous :
Cluster Kubernetes
Routeurs
Pour supprimer un routeur OpenStack, vous devez d'abord retirer les ports qui lui sont liés.
Sous-réseaux
Réseau privé
Aller plus loin
- Landing zone hub and spoke sur OVHcloud Public Cloud
- 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.