Merge branch 'release-0.2.0'
All checks were successful
Documentation / publish (push) Successful in 1m42s

This commit is contained in:
GnomeZworc 2026-10-24 22:19:03 +02:00
commit 5a5e2869d5
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
10 changed files with 106 additions and 14 deletions

View file

@ -11,7 +11,7 @@ DHCP, routage et metadata cloud-init fournis automatiquement.
```bash
curl -O https://git.g3e.fr/syonad/two/raw/branch/main/scripts/deploy.sh
bash ./deploy.sh -t 0.1.0 -i
bash ./deploy.sh -t 0.2.0 -i
```
`deploy.sh` se met à jour lui-même depuis la branche, télécharge binaires, units systemd et

View file

@ -1,7 +1,7 @@
openapi: "3.1.0"
info:
title: Two API
version: "0.1.0"
version: "0.2.0"
description: REST API for managing VPCs, Subnets and VMs in the Two orchestrator.
servers:

View file

@ -11,8 +11,8 @@ import os
project = 'two'
copyright = '2026, Nicolas Boufidjeline'
author = 'Nicolas Boufidjeline'
version = '0.1'
release = '0.1.0'
version = '0.2'
release = '0.2.0'
# -- General configuration ---------------------------------------------------

View file

@ -16,7 +16,7 @@ Déploiement
.. code-block:: bash
curl -O https://git.g3e.fr/syonad/two/raw/branch/main/scripts/deploy.sh
bash ./deploy.sh -t 0.1.0 -i
bash ./deploy.sh -t 0.2.0 -i
``deploy.sh`` se met à jour lui-même depuis la branche avant toute action — s'il diffère, il se
réécrit et demande d'être relancé. Il télécharge ensuite binaires, units systemd et scripts

View file

@ -17,7 +17,7 @@ Il se compose de plusieurs éléments, déployés et versionnés séparément.
- un par hyperviseur : expose une API HTTP qui crée des VPC — isolés par network
namespace —, des subnets — VXLAN ou bridge — et des VM QEMU/KVM raccordées à ces
subnets, avec DHCP, routage et metadata cloud-init
- livré (0.1.0)
- livré (0.2.0)
* - *à venir*
- les composants de niveau supérieur — ordonnancement sur le parc, API d'orchestration,
interface d'administration — sont à documenter au fur et à mesure de leur livraison

View file

@ -6,8 +6,8 @@ Chaque version porte un nom de code dérivé du rang de sa publication : anges e
.. toctree::
:maxdepth: 1
0.2.0
0.1.0
0.2.0 — Bael <0.2.0>
0.1.0 — Michael <0.1.0>
.. include:: ../../release_notes/codenames.md
:parser: myst_parser.sphinx_

View file

@ -0,0 +1,77 @@
# 0.2.0 — rapport de lab
Campagne de validation de la release, avant le tag final.
## Conditions
- **Release testée** : `0.2.0rc009`, publiée par la CI, installée par `deploy.sh` depuis son tag ;
**aucun binaire compilé en local** (`test/e2e/build.sh --clean`) : binaires, units et scripts
(`deploy.sh`, `bootstrap_kvm.sh`) sont ceux de la release. Le code de `0.2.0rc009` est celui de
`0.2.0`, à la date près de `release_notes/codenames.md`
- **Lab** : labctl `0.2.0`, topologie `evpn-3hv.yml` — trois hyperviseurs en KVM imbriqué, deux
route reflectors, deux switchs L3 ; hv1 sur le serveur DHCP intégré (`dhcp.backend: two`), les
autres sur dnsmasq (`dhcp.backend: dnsmasq`)
- **Serveur** : Scaleway EM-B420E-NVME, `fr-par-1`
- **Date** : 2026-10-24, lab prêt à 18:32, suite complète `run.sh --continue all` de 18:32 à 19:40
## Résultats
**29 scénarios, 1031 contrôles réussis, 1 échoué, 3 connus.**
| Scénario | Réussis | Échoués | Connus |
|---|---|---|---|
| `01-lab` | 60 | 0 | 0 |
| `02-prerequis` | 47 | 0 | 0 |
| `03-image` | 14 | 0 | 0 |
| `11-validation` | 46 | 0 | 0 |
| `12-etats` | 28 | **1** | 0 |
| `21-dhcp-two` | 52 | 0 | 0 |
| `22-dhcp-dnsmasq` | 54 | 0 | 0 |
| `23-metadonnees` | 26 | 0 | 0 |
| `24-uefi` | 16 | 0 | 0 |
| `25-multi-nic` | 20 | 0 | 0 |
| `26-multi-disque` | 21 | 0 | 0 |
| `27-reboot` | 18 | 0 | 0 |
| `28-mtu` | 31 | 0 | 0 |
| `31-gateway` | 44 | 0 | 0 |
| `32-vxlan-local` | 27 | 0 | 0 |
| `33-bridge` | 52 | 0 | 0 |
| `34-isolation-locale` | 14 | 0 | 0 |
| `35-filtrage-port` | 25 | 0 | 3 |
| `41-evpn-l2` | 27 | 0 | 0 |
| `42-isolation-evpn` | 17 | 0 | 0 |
| `43-subnets-partages` | 88 | 0 | 0 |
| `44-fenetre-arp` | 28 | 0 | 0 |
| `51-l3vni` | 55 | 0 | 0 |
| `52-migration` | 51 | 0 | 0 |
| `53-watchdog-l3` | 26 | 0 | 0 |
| `61-redemarrage-agent` | 41 | 0 | 0 |
| `62-nettoyage-global` | 54 | 0 | 0 |
| `71-perte-rr` | 31 | 0 | 0 |
| `72-perte-switch` | 18 | 0 | 0 |
## Échec et limites connues
- **`12-etats`, socket QEMU laissée (#84, prévu en 0.3.0).** Une VM démarrée sur un disque absent
passe en `error` ; sa suppression aboutit, mais `/run/two/vms/monitor/<vm>.sock`, créée par QEMU
avant son échec, reste sur l'hyperviseur. Observé à l'identique lors des campagnes précédentes
- **`35-filtrage-port`, trois contrôles connus (#76, prévu en 0.3.0)** : entre deux VM d'un même
hôte, un faux serveur DHCP et l'usurpation ARP de la gateway ou de l'adresse d'émission ne sont
pas filtrés
## Mesures
- **Perte d'un route reflector (`71-perte-rr`)** : 508 réponses pour 508 requêtes, aucune perte
- **Perte d'un switch (`72-perte-switch`)**, sw1 coupé puis rétabli : bascule de la passerelle en
3,3 s, 0,8 s de silence au retour de sw1, sessions EVPN vers les deux route reflectors jamais
coupées ; 242 réponses pour 260 requêtes sur tout le scénario
- **Redémarrage de l'agent (`61-redemarrage-agent`)** : trafic routé ininterrompu, 144 réponses
pour 144 requêtes, plus long silence de 0,2 s
## Ce que la campagne ne couvre pas
- **Le défaut `dhcp.backend: two` (#85)** sur un `agent.yml` sans clé `dhcp.backend` : les
fichiers d'agent du lab déclarent leur backend explicitement. Le serveur intégré lui-même est
couvert par `21-dhcp-two`
- **La mise à jour d'un hyperviseur depuis la 0.1.0** : le lab installe la release sur des hôtes
neufs

View file

@ -125,6 +125,8 @@ L3VNI, avec une configuration BGP pilotée par l'agent ; documentation du projet
absente sans alerte, le temps que la création ou la suppression aboutisse (#78)
- La socket de contrôle répond à `get-state` et à `probe`, ce dernier montrant sans effet de bord
ce qui serait envoyé à une MAC donnée : adresse, masque, routeur, DNS et routes
- `bootstrap_kvm.sh` installe les paquets KVM sans les paquets recommandés et demande `qemu-utils`
explicitement : l'installation, rejouée à chaque démarrage, passe d'environ 270 à 65 Mo (#64)
- Documentation Sphinx du projet : concepts, architecture, déploiement et exploitation
## Correctifs
@ -144,7 +146,13 @@ L3VNI, avec une configuration BGP pilotée par l'agent ; documentation du projet
contrôle et sa socket UDP avant de sortir. Il mourait jusque-là sans nettoyer, et laissait
`/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)
- **Les VXLAN portent l'adresse VTEP locale (#51).** Créés sans adresse source, ils laissaient FRR
sans VTEP local : aucune route EVPN annoncée, et les VM d'un même subnet `vxlan` ne se
joignaient pas d'un hyperviseur à l'autre
- **VM multi-NIC : les interfaces secondaires obtiennent leur bail (#73).** Le `network-config`
servi par le serveur de metadata ne déclarait que `eth0` ; il déclare désormais une entrée par
interface, reconnue par sa MAC. L'image doit en outre lancer DHCP sur toutes ses interfaces
`en*` : voir la documentation de l'image
- **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
@ -159,7 +167,13 @@ L3VNI, avec une configuration BGP pilotée par l'agent ; documentation du projet
démontage ordonné, relecture de la configuration après démontage) et `internal/sysctl` ; une
remarque de `vtysh` (« Configuration applied with notes ») n'est pas une erreur, et la
suppression d'une instance BGP de VRF est réessayée tant que `bgpd` n'a pas libéré la L3VNI
- Les tests du dispatcher arrêtent les workers avant de fermer la base (#47)
- Les tests du dispatcher arrêtent les workers avant de fermer la base (#47), ceux du watchdog
attendent la fin de `Run` avant de la fermer (#83)
- **Lab de test** : labctl, qui monte un lab virtuel (hyperviseurs en KVM imbriqué, route
reflectors, switchs L3), vit dans son propre dépôt (#50, #55) ; la suite `test/e2e` reste dans
two, refondue par fonctionnalité dans un ordre fixe (#70), sur un plan de contrôle redondant —
deux route reflectors, deux switchs (#54). L'image Rocky 10 des VM de test se construit de
façon reproductible dans `syonad/two-images` (#53)
- Le module passe à **Go 1.25**, exigé par la bibliothèque DHCP retenue. La version de Go du
workflow de build, restée à 1.21 alors que le module en demandait davantage, est alignée
- Nouveau paquet `pkg/db/statefile` : persistance générique d'un état de composant dans un
@ -179,8 +193,9 @@ Celles de la 0.1.0 restent valables, sauf mention contraire ci-dessus. S'y ajout
au démarrage, l'ordre est migration réseau, puis FRR, puis l'agent (#52)
- `bootstrap_kvm.sh` active `net.ipv4.ip_forward` en global ; le forwarding que l'agent active
sur les seules interfaces de la VRF n'en restreint donc pas la portée
- **dnsmasq n'est pas retiré** et reste un paquet requis : le backend intégré ne sert que les
subnets créés après la bascule, et le retour arrière suppose dnsmasq installé
- **dnsmasq n'est pas retiré** et reste un paquet requis : il sert les hyperviseurs qui déclarent
`dhcp.backend: dnsmasq`, dont ceux mis à jour avec des subnets existants, et le retour arrière
suppose dnsmasq installé. Son retrait est prévu en 0.4.0 (#49)
- Pas de DNS, pas de pool dynamique, pas de PXE, pas de DHCPv6 dans le serveur intégré
- La comparaison faite par le watchdog porte sur les **réservations** et non sur la configuration
du subnet : celle-ci dépend de la route par défaut de l'host, dont la lecture au moment du

View file

@ -21,7 +21,7 @@ prochain nom disponible sans tenir de compteur ailleurs : c'est la première lig
| # | Nom | Nature | Version | Date |
|---|---|---|---|---|
| 1 | Michael | ange | [0.1.0](0.1.0.md) | 2026-08-26 |
| 2 | Bael | démon | [0.2.0](0.2.0.md) | |
| 2 | Bael | démon | [0.2.0](0.2.0.md) | 2026-10-24 |
| 3 | Gabriel | ange | | |
| 4 | Agares | démon | | |
| 5 | Raphael | ange | | |

View file

@ -1,6 +1,6 @@
#!/bin/sh
set -eu
RELEASE=0.2.0rc008
RELEASE=0.2.0
GIT_SERVER=https://git.g3e.fr/
REPO=syonad/two
n=0