From 9140e90e3749fc6b9b9d7749b78eb111e8acd596 Mon Sep 17 00:00:00 2001 From: GnomeZworc Date: Fri, 30 Oct 2026 01:06:43 +0100 Subject: [PATCH] =?UTF-8?q?f-89:=20doc:=20subnet=20public=5Fip,=20plage=20?= =?UTF-8?q?partag=C3=A9e,=20nommage=20des=20instances=20#89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: GnomeZworc --- docs/concepts/ip-flottante.rst | 1 + docs/concepts/modes-reseau.rst | 38 +++++++++++++++++++++++++------- docs/developpement/lab.rst | 4 ++++ docs/exploitation/diagnostic.rst | 3 ++- release_notes/0.3.0.md | 11 +++++++++ 5 files changed, 48 insertions(+), 9 deletions(-) diff --git a/docs/concepts/ip-flottante.rst b/docs/concepts/ip-flottante.rst index 869e7b0..72c5fcc 100644 --- a/docs/concepts/ip-flottante.rst +++ b/docs/concepts/ip-flottante.rst @@ -79,4 +79,5 @@ Limites ------- * IPv4 seulement. +* Refusée (409) sur une interface d'un subnet ``public_ip`` : la VM y porte déjà son IP publique. * Une VM qui joint l'IP flottante d'une autre VM passe par les bordures. diff --git a/docs/concepts/modes-reseau.rst b/docs/concepts/modes-reseau.rst index 16ea561..fa42968 100644 --- a/docs/concepts/modes-reseau.rst +++ b/docs/concepts/modes-reseau.rst @@ -18,18 +18,13 @@ annoncées aux VM. - rattachement direct à un bridge existant de l'host, résolu depuis ``iface_type`` - disponible * - ``public_ip`` - - routé comme ``vxlan`` côté DHCP - - **mise en place host non implémentée** — la création échoue à l'exécution + - comme ``bridge``, toujours au bridge public de l'host (``interfaces.internet``) ; la VM + porte son IP publique + - disponible * - ``vlan`` - — - réservé, non implémenté -.. warning:: - - ``public_ip`` est accepté par l'API et traité comme ``vxlan`` pour le DHCP, mais sa - configuration réseau côté host n'existe pas encore : la création part en ``error`` dans - ``Execute``. Ne pas s'appuyer dessus en production. - vxlan ----- @@ -138,6 +133,33 @@ Par conception, une VM ne joint pas le netns d'un autre hôte. Les règles sont suppression du subnet ; une règle déjà absente ne fait pas échouer la suppression. Le watchdog signale les règles manquantes et celles qui ne sont pas de l'agent. +public_ip +--------- + +La VM **porte elle-même une IP publique**, sans NAT. Le subnet est raccordé comme un subnet +``bridge``, mais toujours au **bridge public** de l'host (``interfaces.internet``, ``br-public`` +par défaut) ; ``iface_type`` est ignoré. Le bridge du subnet dans le netns porte +``interface_ip`` ; un veth ``v--e`` le relie au bridge public. Le ``br-public`` propre au +netns n'est pas utilisé. + +Une plage publique (plusieurs /24 cohabitent sur le segment) est partagée par tous les VPC qui en +demandent : **chaque VPC a son propre subnet**, avec la **même** ``interface_ip``, sur un même +hôte comme sur des hôtes différents. Les règles de confinement du mode ``bridge`` sont posées sur +chaque ``v--i`` : une VM ne résout ``interface_ip`` que vers le netns de son VPC (sa +gateway, son DHCP, son DNS et son NTP), et ``interface_ip`` n'est jamais visible sur le segment. + +Le **nom** de chaque subnet est choisi par l'appelant et doit être **unique sur l'hyperviseur** : +l'orchestrateur tient un seul subnet public (``pub-203`` par exemple) et en crée une instance par +VPC (``pub-203a42`` pour ``vp-42``). La partie qui suit le premier tiret sert aux noms d'interface +(``br-``, ``v--e``) : 10 caractères au plus. + +Routes annoncées : la route par défaut vers la ``gateway`` fournie (``default_route: true`` et +``gateway`` obligatoires ensemble), la route du ``cidr`` du VPC vers ``interface_ip``. Le contrôle +de MTU est celui du mode ``bridge``, appliqué au bridge public. Les VM de plages publiques se +joignent directement sur le segment ; le filtrage au port les empêche d'usurper l'IP ou la MAC +d'une autre. Une interface d'un subnet ``public_ip`` ne reçoit pas d':doc:`IP flottante +` (409). + Règles de pont -------------- diff --git a/docs/developpement/lab.rst b/docs/developpement/lab.rst index afc0c8a..f748423 100644 --- a/docs/developpement/lab.rst +++ b/docs/developpement/lab.rst @@ -404,6 +404,10 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé - IP flottante d'une interface de VM — macvlan fip- sur le br-public du netns, MAC 02:05 + IP publique, NAT 1:1 sans état, routage par source (sortie par l'IP flottante, pas par la passerelle NAT du VPC), entrée neuve depuis le segment public, métadonnées servies, affichage sur la VM, refus 409, détachement, déplacement vers un autre hôte par mobilité MAC - hv1 hv2 hv3 - #88 + * - ``48-subnet-public`` + - subnet public_ip — VM qui porte son IP publique, subnet raccordé au bridge public de l'hôte (iface_type ignoré), même plage et même interface_ip pour plusieurs VPC sur un même hôte et sur deux hôtes, interface_ip invisible sur le segment, gateway et DNS propres à chaque VPC, sortie et entrée sans NAT, usurpation refusée, IP flottante refusée + - hv1 hv2 hv3 + - #89 * - ``51-l3vni`` - routage inter-subnet entre hôtes par L3VNI (IRB symétrique) — VRF, RMAC, exports /24 et /32, RT-5 réfléchies, TTL, isolation par RT, unreachable default dans la VRF, démontage d'un VPC routé - hv1 hv2 diff --git a/docs/exploitation/diagnostic.rst b/docs/exploitation/diagnostic.rst index f06d16e..1cb045f 100644 --- a/docs/exploitation/diagnostic.rst +++ b/docs/exploitation/diagnostic.rst @@ -14,7 +14,8 @@ La ressource part en ``error`` juste après le 202 Cas fréquents : -* subnet en mode ``public_ip`` — la mise en place host n'est pas implémentée, l'échec est attendu ; +* subnet en mode ``public_ip`` dont le nom n'est pas unique sur l'hyperviseur, ou dont la partie + après le premier tiret dépasse 10 caractères (noms d'interface) ; * ``vxlan_id`` déjà utilisé sur l'host ; * bridge cible absent : ``iface_type`` inconnu retombé sur ``default_interface``, lui-même inexistant. diff --git a/release_notes/0.3.0.md b/release_notes/0.3.0.md index 5066598..59a3223 100644 --- a/release_notes/0.3.0.md +++ b/release_notes/0.3.0.md @@ -102,6 +102,17 @@ - Déplacer l'IP flottante avec la VM : la supprimer sur l'ancien hôte, la créer sur le nouveau. Les connexions en cours sont perdues +**Subnet public_ip (#89)** + +- Le mode `public_ip` est mis en place : la VM porte son IP publique, sans NAT. Le subnet est + raccordé comme `bridge`, toujours au bridge public de l'hôte (`interfaces.internet`) ; + `iface_type` est ignoré, le contrôle de MTU porte sur le bridge public +- Une plage publique est partagée par plusieurs VPC : chacun a son subnet, avec la **même** + `interface_ip`, confinée à son netns par les règles du mode `bridge` (sur un même hôte comme + entre hôtes). Le nom de chaque subnet est choisi par l'appelant et unique sur l'hyperviseur +- Une IP flottante est refusée (409) sur une interface d'un subnet `public_ip`. Le watchdog + contrôle les subnets `public_ip` comme les subnets `bridge` + ## Correctifs - **Chaque VRF de VPC porte une route `unreachable default` (#81).** Une recherche qui échouait