f-89: doc: subnet public_ip, plage partagée, nommage des instances #89

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-30 01:06:43 +01:00
commit 0bcb347140
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
5 changed files with 48 additions and 9 deletions

View file

@ -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.

View file

@ -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-<subnet>-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-<subnet>-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-<id>``, ``v-<id>-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
<ip-flottante>` (409).
Règles de pont
--------------

View file

@ -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-<hex> 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

View file

@ -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.

View file

@ -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