diff --git a/README.md b/README.md index 17ed19a..9a1d9fa 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/api/agent.yaml b/api/agent.yaml index 7e133e7..65c2603 100644 --- a/api/agent.yaml +++ b/api/agent.yaml @@ -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: diff --git a/docs/conf.py b/docs/conf.py index e6cdf00..45e24c3 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -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 --------------------------------------------------- diff --git a/docs/demarrage/installation.rst b/docs/demarrage/installation.rst index 32223e6..ecb8030 100644 --- a/docs/demarrage/installation.rst +++ b/docs/demarrage/installation.rst @@ -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 diff --git a/docs/index.rst b/docs/index.rst index 8eba581..15ac19d 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -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 diff --git a/docs/versions/index.rst b/docs/versions/index.rst index 09f40fa..178b8ab 100644 --- a/docs/versions/index.rst +++ b/docs/versions/index.rst @@ -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_ diff --git a/release_notes/0.2.0-lab.md b/release_notes/0.2.0-lab.md new file mode 100644 index 0000000..6e07b3d --- /dev/null +++ b/release_notes/0.2.0-lab.md @@ -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/.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 diff --git a/release_notes/0.2.0.md b/release_notes/0.2.0.md index ff32269..bbc7c82 100644 --- a/release_notes/0.2.0.md +++ b/release_notes/0.2.0.md @@ -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/_.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 diff --git a/release_notes/codenames.md b/release_notes/codenames.md index fe77557..8715e5a 100644 --- a/release_notes/codenames.md +++ b/release_notes/codenames.md @@ -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 | | | diff --git a/test/e2e/topologies/provision/hypervisor.sh b/test/e2e/topologies/provision/hypervisor.sh index 40e22af..3257dc1 100755 --- a/test/e2e/topologies/provision/hypervisor.sh +++ b/test/e2e/topologies/provision/hypervisor.sh @@ -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