diff --git a/docs/concepts/modes-reseau.rst b/docs/concepts/modes-reseau.rst index a210e89..519696c 100644 --- a/docs/concepts/modes-reseau.rst +++ b/docs/concepts/modes-reseau.rst @@ -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--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 ----------------------- diff --git a/docs/developpement/lab.rst b/docs/developpement/lab.rst index 3a7b599..e7bd6b3 100644 --- a/docs/developpement/lab.rst +++ b/docs/developpement/lab.rst @@ -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 diff --git a/release_notes/0.2.0.md b/release_notes/0.2.0.md index 001f589..82fa1bf 100644 --- a/release_notes/0.2.0.md +++ b/release_notes/0.2.0.md @@ -117,6 +117,14 @@ L3VNI, avec une configuration BGP pilotée par l'agent ; documentation du projet `/run/two/dhcp/_.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, @@ -174,7 +182,8 @@ trois exceptions près, qui touchent les appelants de l'API : garantit l'unicité. Les VM existantes gardent la leur, recopiée au premier démarrage de l'agent 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