f-88: doc: IP flottante, interfaces nommées, notes 0.3.0 #88

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-29 21:56:40 +01:00
commit bcc495ae4a
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
8 changed files with 118 additions and 1 deletions

View file

@ -84,6 +84,24 @@
`syonad_nat_gateways_total` ; le watchdog attend la route par défaut d'une passerelle `running`
dans la VRF
**IP flottante (#88)**
- Nouvelle ressource `/floating-ips` (`POST`, `GET`, `DELETE`) : `name`, `vm`, `interface` (nom de
l'interface de la VM), `ip` (IP publique avec son préfixe) et `gateway`, fournis par l'appelant
et non vérifiés. Créée sur l'hôte de la VM, elle rend l'interface joignable par l'IP publique ;
la VM sort par elle, même dans un VPC qui a une passerelle NAT. 409 si la VM n'est pas `running`
sur l'hôte, si l'interface est inconnue ou a déjà une IP flottante, ou si l'IP publique est déjà
portée
- Dans le netns du VPC : `macvlan` `fip-<hex>` sur `br-public`, de MAC `02:05` + IP publique (la
même sur tout hôte), IP publique en `/32` ; NAT 1:1 sans état en nftables (table `ip two`),
sans `notrack` : métadonnées, DNS et NTP restent servis ; routage par source vers une table
propre, le trafic interne au VPC restant dans `main`
- Le `GET` d'une VM affiche l'IP flottante de chaque interface (`floating_ip`, en lecture seule) ;
la suppression d'une VM est refusée (409) tant qu'une IP flottante y est attachée. Nouvelle
métrique `syonad_floating_ips_total`
- 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
## Correctifs
- **Chaque VRF de VPC porte une route `unreachable default` (#81).** Une recherche qui échouait