f-75: doc: mode bridge sur plusieurs hôtes, interface_ip confinée à son hôte, notes de version #75

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-23 10:28:17 +02:00
commit f7801c6f14
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
3 changed files with 35 additions and 3 deletions

View file

@ -122,6 +122,29 @@ bridge
Le subnet est rattaché directement à un bridge existant de l'host. Pas de tunnel, pas de route
VPC : le trafic sort par le bridge, et la VM est joignable depuis l'host.
Le même subnet peut être posé sur plusieurs hôtes raccordés au même segment. Chaque hôte porte
alors la **même** ``interface_ip`` dans son netns, avec sa propre MAC. Pour qu'une VM ne voie que
l'``interface_ip`` de son hôte (gateway, metadata, DHCP), l'agent pose quatre règles ebtables sur
le veth du subnet dans le netns (``v-<subnet>-i``), en sortie vers le bridge de l'host :
* les requêtes ARP des VM **vers** ``interface_ip`` ne quittent pas l'hôte (``FORWARD``) ;
* l'ARP émis **depuis** ``interface_ip`` par le netns, requêtes et réponses, ne sort pas
(``OUTPUT``) : une VM d'un autre hôte n'associe jamais ``interface_ip`` à cet hôte ;
* le DHCP émis depuis ``interface_ip`` ne sort ni en transit (``FORWARD``) ni depuis le serveur
local lui-même (``OUTPUT``).
Le trafic entre VM du subnet, sur un même hôte ou sur des hôtes différents, n'est pas concerné.
Par conception, une VM ne joint pas le netns d'un autre hôte. Les règles sont retirées à la
suppression du subnet ; une règle déjà absente ne fait pas échouer la suppression. Le watchdog
signale les règles manquantes.
.. note::
Un subnet ``bridge`` créé par une version antérieure de l'agent n'a que la règle DHCP
``FORWARD`` : il reste exposé jusqu'à sa recréation, et le watchdog le signale. L'agent ne
répare pas les règles au démarrage. Les règles ne couvrent que IPv4 : le voisinage IPv6 du
netns relève de #61.
Routes annoncées aux VM
-----------------------

View file

@ -336,9 +336,9 @@ Générée par ``test/e2e/run.sh --matrice`` à partir des en-têtes ; à régé
- hv1
- #57, #41
* - ``33-bridge``
- subnet en mode bridge rattaché au bridge br-lan de l'hôte — un hôte, puis le même subnet sur deux hôtes (une seule réponse ARP pour interface_ip, métadonnées servies par l'hôte de la VM)
- subnet en mode bridge rattaché au bridge br-lan de l'hôte — un hôte, puis le même subnet sur deux hôtes (interface_ip confinée à son hôte : une seule réponse ARP, métadonnées servies par l'hôte de la VM, ni ARP ni DHCP de la gateway sur le segment, règles surveillées par le watchdog)
- hv1 hv2
- #70
- #70, #75
* - ``34-isolation-locale``
- isolation entre deux VPC sur un même hôte — ni ICMP ni TCP d'un VPC à l'autre
- hv1

View file

@ -129,6 +129,14 @@ L3VNI, avec une configuration BGP pilotée par l'agent ; documentation du projet
`/run/two/dhcp/<netns>_<bridge>.sock` après la suppression du subnet. L'agent supprime aussi
cette socket avec le fichier d'état, ce qui couvre une mort brutale du processus (#77)
- **Mode `bridge` sur plusieurs hôtes : `interface_ip` confinée à son hôte (#75).** Chaque hôte
portant la même `interface_ip`, une VM obtenait parfois l'ARP, les métadonnées ou le DHCP d'un
autre hôte : en lab, une VM ne recevait ses propres métadonnées que 3 à 4 fois sur 5. L'agent
bloque désormais vers le segment les requêtes ARP vers `interface_ip`, l'ARP émis depuis elle
et le DHCP émis depuis elle, y compris par le serveur local (chaîne `OUTPUT`, que la règle
précédente ne couvrait pas). Le watchdog signale une règle manquante ; la suppression d'un
subnet ne retire que les règles présentes
## Changements internes
- Nouveaux paquets `internal/frr` (seul point d'appel à `vtysh` : génération des commandes,
@ -189,7 +197,8 @@ quatre exceptions près, qui touchent les appelants de l'API :
qui les montait par `/dev/sdY` doit passer à `/dev/xvdX`
Les subnets `vxlan` existants gardent leur adressage et le modèle précédent (gateway sur le
bridge) jusqu'à leur recréation.
bridge) jusqu'à leur recréation. Les subnets `bridge` existants restent sans le confinement de
`interface_ip` (#75) jusqu'à leur recréation ; le watchdog les signale.
Pour router entre hyperviseurs : ajouter la section `bgp`, réduire `frr.conf` à `hostname` et
`log` (l'agent pose le reste), puis créer les VPC avec `l3vni`. Pour passer au serveur intégré, suivre la procédure de bascule dans la