f-56: doc: MTU unique du cluster, underlay à 9000, section network, notes de version #56

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-23 12:10:15 +02:00
commit c94c93b443
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
5 changed files with 80 additions and 12 deletions

View file

@ -104,6 +104,32 @@ Traduit les clés logiques ``iface_type`` de l'API vers les bridges physiques de
inconnue ou omise retombe silencieusement sur ``default_interface`` — ce n'est pas une erreur,
mais c'est une source de subnets branchés au mauvais endroit sans le dire.
MTU
---
.. code-block:: yaml
network:
mtu_vm: 1500
allow_mtu_vm_below_1500: false
allow_mtu_underlay_below_9000: false
* ``mtu_vm`` — le MTU de toutes les VM, et de tous les bridges, veth, taps et interfaces VXLAN
que l'agent crée. Il est annoncé aux VM par l'option DHCP 26 et par ``host_mtu``. **Il doit
être identique sur tous les hyperviseurs.** 1500 au plus ; en dessous, seulement avec
``allow_mtu_vm_below_1500``, et jamais sous 1280. Une valeur hors de ces bornes fait échouer
le démarrage de l'agent.
* ``allow_mtu_underlay_below_9000`` — l'underlay est attendu à exactement 9000. Sans cette
option, un subnet ``vxlan`` dont l'interface (celle de ``iface_type``, ou
``default_interface``) n'est pas à 9000 est refusé (422), comme un VPC avec ``l3vni`` si
``default_interface`` ne l'est pas (409). Dans tous les cas, l'underlay doit faire au moins
``mtu_vm`` + 50 (en-tête VXLAN).
Un subnet ``bridge`` est refusé (422) si son bridge est sous ``mtu_vm`` ; il n'y a pas
d'encapsulation, donc pas de marge à prévoir. Les interfaces sont créées au MTU en vigueur à la
création du subnet : changer ``mtu_vm`` ne modifie pas les subnets existants, il faut les
recréer.
Plan de contrôle BGP
--------------------