Audit doc ↔ code et revue de #70 : commandes et API fausses dans la doc, faux positifs e2e #80

Closed
opened 2026-10-17 23:45:19 +00:00 by nicolas.boufideline · 2 comments

Contexte

Deux analyses menées le 2026-10-18 sur main (3c3e58a) :

  • audit doc ↔ code : README, docs/, api/agent.yaml, schémas, confrontés au code actuel ;
  • revue de la feature #70 : les 13 commits f-70: (0932f5d → 683e0fe), doc, générateurs de schémas, scripts e2e.

Rien de bloquant côté code livré. Les conventions sont respectées (commits signés, préfixe f-70:, VPC au masculin dans la doc). Les SVG sont identiques octet pour octet à la sortie de gen_ensemble.py / gen_cluster.py. La matrice de lab.rst correspond à run.sh --matrice.

Non vérifié : build Sphinx strict et shellcheck (absents du poste), aucun scénario e2e lancé (lab éteint).

Décisions à prendre

  • D1 — répertoire UEFI : conf/agent/config.exemple.yml:67, configuration.rst:150 et diagnostic.rst:151 donnent /run/two/vms/efi ; le défaut du code est /run/two/vms/uefi (internal/config/agent/struct.go:83). Aligner la doc ou le code.
  • D2 — route reflectors par cluster : architecture-cluster.rst:47-52 et gen_ensemble.py:202 disent « un par cluster » ; route-reflector.rst:6, routeurs.rst:21 et gen_cluster.py:48 disent « deux ». Trancher, puis régénérer les SVG.
  • D3 — gateway et vxlan_id dans l'API : corriger le code ou la spec (voir A-M13).
  • D4 — VRRP et préemption : lab.rst:79-80 dit « sans préemption », alors que la campagne (lab.rst:406-407) et 72-perte-switch.sh constatent que sw1 (priorité 200) redevient maître à son retour. Décrire le comportement réel ou désactiver la préemption ; en attendant, ne pas écrire « sans préemption » ailleurs (cf. A-M9).

A. Doc ↔ code

Haute

  • A-H1 — résultats de lab dans docs/deploiement : route-reflector.rst:85-93 cite « 30 s / 90 s », « 31 s » (s6-rr-loss du 2026-10-04) — contraire à la règle (résultats de lab dans docs/developpement). Le passage est en plus périmé : « un seul RR, redondance non qualifiée », alors que #54 est fermé, que 71-perte-rr existe et que la campagne du 2026-10-13 a perdu 0 requête sur 510 (lab.rst:581). Réécrire sans chiffres : sans graceful-restart, la perte de tous les RR coupe les tunnels, d'où deux RR jamais sur le même hôte.
  • A-H2 — README.md:31 : -V ne désactive pas la vérification (scripts/deploy.sh:340, booléen shflags à true par défaut) ; c'est --noverify (ce que dit déjà installation.rst:61).
  • A-H3 — option -b (README.md:26, installation.rst:35-37) : elle ne sert qu'à l'auto-mise à jour du script et au bootstrap, les binaires viennent toujours d'une release. Défaut main/, / final obligatoire : l'URL est concaténée sans séparateur (deploy.sh:330, :349), -b dev donne …/branch/devscripts/….
  • A-H4 — nom de bridge br-sn000001 (premier-vpc.rst:17, services.rst:33-34 et :68-70, observabilite.rst:75-76) : le nom réel est br-000001 (internal/subnet/data.go:31-32, br- + ce qui suit le premier tiret). Les commandes systemctl / tail / journalctl visent des units inexistantes. Dans le mermaid, le bridge porte .253 (émission), la gateway .254 est sur le macvlan gw-000001.
  • A-H5 — subnet sur un VPC en creating (premier-vpc.rst:46-47, exploitation/api-agent/asynchronisme.rst:51-53) : présenté comme refusé en 422. Prepare accepte un VPC en creating ou running (dispatcher/agent/subnet_commands.go:58), Execute attend running dans la limite de dispatcher.timeout_seconds (:83-102). 422 seulement si le parent est absent, en error ou en deleting.
  • A-H6 — tableau des codes, asynchronisme.rst:69 : un iface_type inconnu ne donne pas 400, il retombe sur default_interface (subnet_commands.go:62-65). Manquent en 400 : CIDR de VPC invalide, l3vni hors plage, interface_ip absent (bridge/public_ip) ou fourni (vxlan), nombre de primary ≠ 1. En 422 : mode inconnu, CIDR vxlan invalide ou < /29, IP de VM hors CIDR ou réservée. En 409 : l3vni déjà utilisée, ou l3vni sans section bgp.
  • A-H7 — diagnostic.rst:117 : curl …/latest/meta-data/ renvoie 404 ; le serveur ne sert que /meta-data, /user-data, /network-config, /vendor-data (internal/metadata/server.go:58-69).
  • A-H8 — observabilite.rst:85 : /opt/two/bin/db -conf … sans sous-commande n'affiche que l'usage (cmd/db/main.go:140), et db n'est ni publié (release-pipeline.yml:51-54) ni déployé (deploy.sh:127). Documenter go build ./cmd/db puis ./db -conf … print, ou livrer le binaire.
  • A-H9 — premier-vpc.rst:132-136 : ssh « depuis l'host » impossible sur un subnet vxlan (la note l.140 le dit elle-même). Passer par ip netns exec vp-admin ssh ….

Moyenne

  • A-M1 — voir D1.
  • A-M2 — binaire dhcp absent du README (README.md:38, :72-80) : « trois binaires » → quatre ; « les deux autres -conf » → les trois autres.
  • A-M3 — br-public en dur (internal/vpc/create.go:30-40, veth vp-<id>-e ↔ vp-<id>-i) alors que installation.rst:50-52 et concepts/vpc-subnet-vm.rst:15-21 présentent -P comme libre : avec un autre nom, toute création de VPC échoue. Documenter le veth et la contrainte, ou rendre le nom configurable.
  • A-M4 — routes annoncées (concepts/modes-reseau.rst:128-133, :143, :156) : la route par défaut ne va qu'à l'interface primary (internal/vm/create.go:138) ; en mode bridge, la route du CIDR du VPC n'est pas annoncée (internal/subnet/routing.go).
  • A-M5 — user_data vide ≠ absent (concepts/metadata-cloud-init.rst:23-30, diagnostic.rst:134-135) : faux, un user_data vide équivaut à absent (internal/api/agent/vms.go:130-133) ; seul user-data est fourni par l'appelant, les autres documents viennent toujours de leur template. La spec (api/agent.yaml:506) est juste.
  • A-M6 — watchdog présenté comme actif (configuration.rst:229-233, observabilite.rst:34-36) : défaut enabled: false (struct.go:86).
  • A-M7 — renvoi à un CLAUDE.md absent (architecture/index.rst:5-6, architecture/contraintes.rst:7-10) : le fichier n'est pas dans le dépôt et ne l'a jamais été. Retirer les deux mentions.
  • A-M8 — architecture/vue-densemble.rst:26-76 : le tableau des paquets n'a pas internal/dhcpd, internal/dhcpbackend, internal/api/dhcp, internal/client/dhcp, pkg/db/statefile, internal/watchdog/notify.
  • A-M9 — #54 présenté comme ouvert (routeurs.rst:62-65 et :76-78, route-reflector.rst:8, lab.rst:19-20) : #54 est fermé (VRRP v3 sur sw1/sw2, rr1/rr2, test 72). Formulation de la préemption selon D4.
  • A-M10 — voir D2.
  • A-M11 — concepts/vpc-subnet-vm.rst:100-101 : clé vm/<name>/subnet périmée → vm/<name>/nic/<i>/subnet (vm_commands.go:55, migration/nic.go:16).
  • A-M12 — vpc-subnet-vm.rst:108-109 : le motif vp-… est présenté comme validé par l'API ; postVpc ne vérifie que name et cidr (vpcs.go:58-80). Écrire que l'API ne valide aucun nommage, mais qu'un nom de VPC ou de subnet doit contenir un « - » (l'identifiant système est ce qui suit le premier tiret).
  • A-M13 — api/agent.yaml vs code :
    • :439 : vxlan_id « present only when vxlan », mais toujours renvoyé (0 hors vxlan), faute d'omitempty (models.go:32) — D3 ;
    • :461 : gateway n'est rempli que par GET /subnets/{name}, absent de GET /subnets et du 202 de POST (subnets.go:43-60, :121-141) — plutôt un défaut de code, D3 ;
    • :48 : le 400 de POST /vpcs ne mentionne pas le CIDR invalide ;
    • :361 : aucun pattern sur le nom de subnet, alors qu'un nom sans « - » fait paniquer le worker (subnet/data.go:31, SplitN(...)[1]). Ajouter pattern: '^[^-]+-.+' ; la validation elle-même relève de l'appelant (twoctl / orchestrateur) ;
    • :485 : pas de maxItems, alors qu'une VM accepte au plus 27 interfaces (qemu/start_linux.go:15).
  • A-M14 — diagnostic.rst:52 : | jq .lease masque "served": false, l'indice recherché → jq '{served, lease}'.
  • A-M15 — installation.rst:34 : -t prend la dernière release préversions comprises (aujourd'hui 0.2.0rc008), à préciser.

Basse

  • README.md:52, premier-vpc.rst:59 : vxlan_id: 1 tombe dans la plage réservée aux L3VNI (vpc-subnet-vm.rst:32) ; prendre 65537.
  • concepts/cycle-de-vie.rst:13 : la transition running → error n'existe pas ; error n'est posé que par l'échec d'Execute ou par la migration.
  • api/agent.yaml:4-5 : version 0.1.0, description sans les VM.
  • docs/index.rst:20, docs/conf.py:14-15 : « livré (0.1.0) », release '0.1.0' ; à basculer au tag 0.2.0.
  • services.rst:4 : les units ne sont pas sous /opt/two/bin, seuls les binaires y sont.
  • asynchronisme.rst:81 : 405 non documentés ; /vpcs et /subnets les renvoient en text/plain, /vms en JSON.
  • lab.rst:7, :72, :89 : « le route reflector » au singulier.
  • premier-hyperviseur.rst:84, :96 : renvoi à 0.2.0rc003 et « à trancher dans #51 », #51 est fermé.
  • docs/README.md:17 : le build local n'a pas -W --keep-going comme la CI (docs.yml:76).
  • README.md:61 vs premier-vpc.rst:97 : chemins de disque d'exemple différents.
  • test/e2e/build.sh:13 : l'aide parle de « release de la topologie », la release est désormais fixée dans provision/hypervisor.sh.

B. Revue de #70

Important

  • B-1 — garde de run.sh inopérante (0932f5d, test/e2e/run.sh:69,75, lib/fixture.sh:78-79) : finish_test ajoute toujours deux RÉUSSI (teardown, assert_clean), donc passed -gt 0 ne détecte plus un scénario dont aucun check propre n'a tourné (erreur bash dans le fichier sourcé, on muet). Relever passed avant finish_test.
  • B-2 — contrôle muet dans suite/01-lab.sh:23 (432b582) : check "…backend DHCP…" grep … | grep -qx … — le pipe s'applique à la sortie de check, la ligne RÉUSSI/ÉCHOUÉ est avalée, le contrôle ne compte jamais. → check "…" sh -c "grep -A1 -x 'dhcp:' /etc/two/agent.yml | grep -qx ' backend: ${BACKEND}'".
  • B-3 — tests non autonomes sur lab neuf (9e08b69, lab.rst:258) : TWO_IMAGE n'est construite que par two_image, appelé seulement dans 01-lab.sh ; vm_create/vm_launch (lib/vm.sh), 11-validation.sh, 12-etats.sh font un cp sans la créer. run.sh 21 échoue tant que 01 n'a pas tourné. → [ -f "${TWO_IMAGE}" ] || two_image dans lib/vm.sh.
  • B-4 — voir D4.
  • B-5 — schéma du cluster (fa42096 / eeb77c3, gen_cluster.py:18,29) : vxlan-<vni> est dessiné dans le br-<subnet> du netns du VPC. Le code crée deux bridges br-<id> (internal/subnet/create.go:145-165) : un dans le netns racine (vxlan + v-<id>-e), un dans le netns du VPC (v-<id>-i, gw-, tap). Ajouter le bridge côté hôte et le veth qui traverse la frontière.

Mineur — réseau, doc et schémas

  • B-6 — multi-cluster (86923ea, architecture-cluster.rst:27,47) : préciser que le bgp listen range des RR doit couvrir l'underlay des deux clusters (aujourd'hui rr1.conf n'accepte que 192.168.14.0/24), et que chaque cluster a un ASN de routeurs distinct (AS 65100 « valeur de production » vaut par cluster). Dépend de D2.
  • B-7 — gen_cluster.py:47,62 : « AS 65000 » et « iBGP AS 64600 » côte à côte sans le local-as 64600 no-prepend replace-as (route-reflector.rst:76).
  • B-8 — gen_ensemble.py:181 : la flèche du poste opérateur va directement à l'orchestrateur, alors que le texte dit « par Internet et les bordures (VNI 66001) », et croise les deux liens eBGP.
  • B-9 — architecture-cluster.rst:82,114 : « du route reflector », « le route reflector qui les fait converger » au singulier.
  • B-10 : aria-label de gen_cluster.py:93 (« Architecture du cluster… ») ≠ alt RST (« Détail d'un cluster… ») ; gen_ensemble.py:210 « routeurs du cluster » au singulier.
  • B-13 — architecture-cluster.rst:44 + note de gen_ensemble.py : « les NAT » employé comme verbe → « les traduisent (NAT) ».

Mineur — conventions

  • B-11 — gen_ensemble.py:81,91,97,104… : ~9 commentaires de section, contraires à la convention (gen_cluster.py n'en a aucun).
  • B-12 — suite/12-etats.sh:40-41 : VPC au féminin (« vp-t12a supprimée », « recréée »).

Mineur — scripts e2e

  • B-14 — lib/core.sh:62 : wait_state … deleted réussit si l'API est injoignable (curl -f vide = supprimé) ; même faux positif dans teardown_owned / delete_owned. Distinguer 404 et échec de connexion via api_code.
  • B-15 — lib/evpn.sh:82-94,130-134 : les *_quiet réussissent si journalctl échoue ; sans 2ᵉ argument, watchdog_quiet échoue toujours (latent).
  • B-16 — 33-bridge.sh:24, 23-metadonnees.sh:25,28,33-34 : tests négatifs fondés sur une sortie vide de vm_ssh / curl ; un SSH en panne les fait passer (contraire à lab.rst:464). Vérifier d'abord le succès de la commande.
  • B-17 — nettoyage hors assert_clean : /tmp/t21-*2.log, /tmp/t22-*.log, /tmp/t44.log, /tmp/t72.*, /var/tmp/e2e/t61.* jamais supprimés ; netns t02-ebt non nettoyé avant recréation (02-prerequis.sh:22).
  • B-18 (4e4ad7f) : 71-perte-rr.sh:61-65 ne vérifie pas le volume de requêtes émises et END{print n,max} n'a pas de +0 (aligner sur 61-redemarrage-agent.sh:69) ; 72-perte-switch.sh:41-45 coupe l'underlay de sw2 même si l'état VRRP est illisible.
  • B-19 — run.sh:104 : run.sh 4 lance silencieusement le seul 41 ; run.sh dhcp-two refusé alors que l'usage et lab.rst:242 annoncent « par nom ». Exiger deux chiffres ou le nom exact.
  • B-20 — lab.rst:435 : la liste de core.sh omet known_flaky ; :455-463, l'exemple vise une cible inexistante (10.98.1.10), contraire à la règle « la cible est vivante ».

Note sans action : eeb77c3 mélange l'ajout des générateurs et la passe « VPC au masculin ».

Ordre proposé

  1. B-1, B-2, B-3, B-14 à B-19 : les faux positifs et dépendances cachées des e2e, avant toute nouvelle campagne.
  2. A-H1 à A-H9 : commandes et API fausses dans la doc.
  3. D1 à D4, puis les points qui en dépendent.
  4. Le reste.
## Contexte Deux analyses menées le 2026-10-18 sur `main` (3c3e58a) : - **audit doc ↔ code** : README, `docs/`, `api/agent.yaml`, schémas, confrontés au code actuel ; - **revue de la feature #70** : les 13 commits `f-70:` (0932f5d → 683e0fe), doc, générateurs de schémas, scripts e2e. Rien de bloquant côté code livré. Les conventions sont respectées (commits signés, préfixe `f-70:`, VPC au masculin dans la doc). Les SVG sont identiques octet pour octet à la sortie de `gen_ensemble.py` / `gen_cluster.py`. La matrice de `lab.rst` correspond à `run.sh --matrice`. Non vérifié : build Sphinx strict et shellcheck (absents du poste), aucun scénario e2e lancé (lab éteint). ## Décisions à prendre - [ ] **D1 — répertoire UEFI** : `conf/agent/config.exemple.yml:67`, `configuration.rst:150` et `diagnostic.rst:151` donnent `/run/two/vms/efi` ; le défaut du code est `/run/two/vms/uefi` (`internal/config/agent/struct.go:83`). Aligner la doc ou le code. - [ ] **D2 — route reflectors par cluster** : `architecture-cluster.rst:47-52` et `gen_ensemble.py:202` disent « un par cluster » ; `route-reflector.rst:6`, `routeurs.rst:21` et `gen_cluster.py:48` disent « deux ». Trancher, puis régénérer les SVG. - [ ] **D3 — `gateway` et `vxlan_id` dans l'API** : corriger le code ou la spec (voir A-M13). - [ ] **D4 — VRRP et préemption** : `lab.rst:79-80` dit « sans préemption », alors que la campagne (`lab.rst:406-407`) et `72-perte-switch.sh` constatent que sw1 (priorité 200) redevient maître à son retour. Décrire le comportement réel ou désactiver la préemption ; en attendant, ne pas écrire « sans préemption » ailleurs (cf. A-M9). ## A. Doc ↔ code ### Haute - [ ] **A-H1 — résultats de lab dans `docs/deploiement`** : `route-reflector.rst:85-93` cite « 30 s / 90 s », « 31 s » (s6-rr-loss du 2026-10-04) — contraire à la règle (résultats de lab dans `docs/developpement`). Le passage est en plus périmé : « un seul RR, redondance non qualifiée », alors que #54 est fermé, que 71-perte-rr existe et que la campagne du 2026-10-13 a perdu 0 requête sur 510 (`lab.rst:581`). Réécrire sans chiffres : sans `graceful-restart`, la perte de **tous** les RR coupe les tunnels, d'où deux RR jamais sur le même hôte. - [ ] **A-H2 — `README.md:31`** : `-V` ne désactive pas la vérification (`scripts/deploy.sh:340`, booléen shflags à true par défaut) ; c'est `--noverify` (ce que dit déjà `installation.rst:61`). - [ ] **A-H3 — option `-b`** (`README.md:26`, `installation.rst:35-37`) : elle ne sert qu'à l'auto-mise à jour du script et au bootstrap, les binaires viennent toujours d'une release. Défaut `main/`, `/` final obligatoire : l'URL est concaténée sans séparateur (`deploy.sh:330`, `:349`), `-b dev` donne `…/branch/devscripts/…`. - [ ] **A-H4 — nom de bridge `br-sn000001`** (`premier-vpc.rst:17`, `services.rst:33-34` et `:68-70`, `observabilite.rst:75-76`) : le nom réel est `br-000001` (`internal/subnet/data.go:31-32`, `br-` + ce qui suit le premier tiret). Les commandes `systemctl` / `tail` / `journalctl` visent des units inexistantes. Dans le mermaid, le bridge porte `.253` (émission), la gateway `.254` est sur le macvlan `gw-000001`. - [ ] **A-H5 — subnet sur un VPC en `creating`** (`premier-vpc.rst:46-47`, `exploitation/api-agent/asynchronisme.rst:51-53`) : présenté comme refusé en 422. Prepare accepte un VPC en `creating` ou `running` (`dispatcher/agent/subnet_commands.go:58`), Execute attend `running` dans la limite de `dispatcher.timeout_seconds` (`:83-102`). 422 seulement si le parent est absent, en `error` ou en `deleting`. - [ ] **A-H6 — tableau des codes, `asynchronisme.rst:69`** : un `iface_type` inconnu ne donne pas 400, il retombe sur `default_interface` (`subnet_commands.go:62-65`). Manquent en 400 : CIDR de VPC invalide, `l3vni` hors plage, `interface_ip` absent (bridge/public_ip) ou fourni (vxlan), nombre de `primary` ≠ 1. En 422 : `mode` inconnu, CIDR vxlan invalide ou < /29, IP de VM hors CIDR ou réservée. En 409 : `l3vni` déjà utilisée, ou `l3vni` sans section `bgp`. - [ ] **A-H7 — `diagnostic.rst:117`** : `curl …/latest/meta-data/` renvoie 404 ; le serveur ne sert que `/meta-data`, `/user-data`, `/network-config`, `/vendor-data` (`internal/metadata/server.go:58-69`). - [ ] **A-H8 — `observabilite.rst:85`** : `/opt/two/bin/db -conf …` sans sous-commande n'affiche que l'usage (`cmd/db/main.go:140`), et `db` n'est ni publié (`release-pipeline.yml:51-54`) ni déployé (`deploy.sh:127`). Documenter `go build ./cmd/db` puis `./db -conf … print`, ou livrer le binaire. - [ ] **A-H9 — `premier-vpc.rst:132-136`** : `ssh` « depuis l'host » impossible sur un subnet vxlan (la note l.140 le dit elle-même). Passer par `ip netns exec vp-admin ssh …`. ### Moyenne - [ ] **A-M1** — voir D1. - [ ] **A-M2 — binaire `dhcp` absent du README** (`README.md:38`, `:72-80`) : « trois binaires » → quatre ; « les deux autres `-conf` » → les trois autres. - [ ] **A-M3 — `br-public` en dur** (`internal/vpc/create.go:30-40`, veth `vp-<id>-e` ↔ `vp-<id>-i`) alors que `installation.rst:50-52` et `concepts/vpc-subnet-vm.rst:15-21` présentent `-P` comme libre : avec un autre nom, toute création de VPC échoue. Documenter le veth et la contrainte, ou rendre le nom configurable. - [ ] **A-M4 — routes annoncées** (`concepts/modes-reseau.rst:128-133`, `:143`, `:156`) : la route par défaut ne va qu'à l'interface `primary` (`internal/vm/create.go:138`) ; en mode `bridge`, la route du CIDR du VPC n'est pas annoncée (`internal/subnet/routing.go`). - [ ] **A-M5 — `user_data` vide ≠ absent** (`concepts/metadata-cloud-init.rst:23-30`, `diagnostic.rst:134-135`) : faux, un `user_data` vide équivaut à absent (`internal/api/agent/vms.go:130-133`) ; seul `user-data` est fourni par l'appelant, les autres documents viennent toujours de leur template. La spec (`api/agent.yaml:506`) est juste. - [ ] **A-M6 — watchdog présenté comme actif** (`configuration.rst:229-233`, `observabilite.rst:34-36`) : défaut `enabled: false` (`struct.go:86`). - [ ] **A-M7 — renvoi à un `CLAUDE.md` absent** (`architecture/index.rst:5-6`, `architecture/contraintes.rst:7-10`) : le fichier n'est pas dans le dépôt et ne l'a jamais été. Retirer les deux mentions. - [ ] **A-M8 — `architecture/vue-densemble.rst:26-76`** : le tableau des paquets n'a pas `internal/dhcpd`, `internal/dhcpbackend`, `internal/api/dhcp`, `internal/client/dhcp`, `pkg/db/statefile`, `internal/watchdog/notify`. - [ ] **A-M9 — #54 présenté comme ouvert** (`routeurs.rst:62-65` et `:76-78`, `route-reflector.rst:8`, `lab.rst:19-20`) : #54 est fermé (VRRP v3 sur sw1/sw2, rr1/rr2, test 72). Formulation de la préemption selon D4. - [ ] **A-M10** — voir D2. - [ ] **A-M11 — `concepts/vpc-subnet-vm.rst:100-101`** : clé `vm/<name>/subnet` périmée → `vm/<name>/nic/<i>/subnet` (`vm_commands.go:55`, `migration/nic.go:16`). - [ ] **A-M12 — `vpc-subnet-vm.rst:108-109`** : le motif `vp-…` est présenté comme validé par l'API ; `postVpc` ne vérifie que `name` et `cidr` (`vpcs.go:58-80`). Écrire que l'API ne valide aucun nommage, mais qu'un nom de VPC ou de subnet doit contenir un « - » (l'identifiant système est ce qui suit le premier tiret). - [ ] **A-M13 — `api/agent.yaml` vs code** : - `:439` : `vxlan_id` « present only when vxlan », mais toujours renvoyé (0 hors vxlan), faute d'`omitempty` (`models.go:32`) — D3 ; - `:461` : `gateway` n'est rempli que par `GET /subnets/{name}`, absent de `GET /subnets` et du 202 de POST (`subnets.go:43-60`, `:121-141`) — plutôt un défaut de code, D3 ; - `:48` : le 400 de `POST /vpcs` ne mentionne pas le CIDR invalide ; - `:361` : aucun `pattern` sur le nom de subnet, alors qu'un nom sans « - » fait paniquer le worker (`subnet/data.go:31`, `SplitN(...)[1]`). Ajouter `pattern: '^[^-]+-.+'` ; la validation elle-même relève de l'appelant (twoctl / orchestrateur) ; - `:485` : pas de `maxItems`, alors qu'une VM accepte au plus 27 interfaces (`qemu/start_linux.go:15`). - [ ] **A-M14 — `diagnostic.rst:52`** : `| jq .lease` masque `"served": false`, l'indice recherché → `jq '{served, lease}'`. - [ ] **A-M15 — `installation.rst:34`** : `-t` prend la dernière release **préversions comprises** (aujourd'hui 0.2.0rc008), à préciser. ### Basse - [ ] `README.md:52`, `premier-vpc.rst:59` : `vxlan_id: 1` tombe dans la plage réservée aux L3VNI (`vpc-subnet-vm.rst:32`) ; prendre 65537. - [ ] `concepts/cycle-de-vie.rst:13` : la transition `running → error` n'existe pas ; `error` n'est posé que par l'échec d'Execute ou par la migration. - [ ] `api/agent.yaml:4-5` : version 0.1.0, description sans les VM. - [ ] `docs/index.rst:20`, `docs/conf.py:14-15` : « livré (0.1.0) », release `'0.1.0'` ; à basculer au tag 0.2.0. - [ ] `services.rst:4` : les units ne sont pas sous `/opt/two/bin`, seuls les binaires y sont. - [ ] `asynchronisme.rst:81` : 405 non documentés ; `/vpcs` et `/subnets` les renvoient en `text/plain`, `/vms` en JSON. - [ ] `lab.rst:7`, `:72`, `:89` : « le route reflector » au singulier. - [ ] `premier-hyperviseur.rst:84`, `:96` : renvoi à 0.2.0rc003 et « à trancher dans #51 », #51 est fermé. - [ ] `docs/README.md:17` : le build local n'a pas `-W --keep-going` comme la CI (`docs.yml:76`). - [ ] `README.md:61` vs `premier-vpc.rst:97` : chemins de disque d'exemple différents. - [ ] `test/e2e/build.sh:13` : l'aide parle de « release de la topologie », la release est désormais fixée dans `provision/hypervisor.sh`. ## B. Revue de #70 ### Important - [ ] **B-1 — garde de `run.sh` inopérante** (0932f5d, `test/e2e/run.sh:69,75`, `lib/fixture.sh:78-79`) : `finish_test` ajoute toujours deux `RÉUSSI` (teardown, `assert_clean`), donc `passed -gt 0` ne détecte plus un scénario dont aucun check propre n'a tourné (erreur bash dans le fichier sourcé, `on` muet). Relever `passed` avant `finish_test`. - [ ] **B-2 — contrôle muet dans `suite/01-lab.sh:23`** (432b582) : `check "…backend DHCP…" grep … | grep -qx …` — le pipe s'applique à la sortie de `check`, la ligne RÉUSSI/ÉCHOUÉ est avalée, le contrôle ne compte jamais. → `check "…" sh -c "grep -A1 -x 'dhcp:' /etc/two/agent.yml | grep -qx ' backend: ${BACKEND}'"`. - [ ] **B-3 — tests non autonomes sur lab neuf** (9e08b69, `lab.rst:258`) : `TWO_IMAGE` n'est construite que par `two_image`, appelé seulement dans `01-lab.sh` ; `vm_create`/`vm_launch` (`lib/vm.sh`), `11-validation.sh`, `12-etats.sh` font un `cp` sans la créer. `run.sh 21` échoue tant que 01 n'a pas tourné. → `[ -f "${TWO_IMAGE}" ] || two_image` dans `lib/vm.sh`. - [ ] **B-4** — voir D4. - [ ] **B-5 — schéma du cluster** (fa42096 / eeb77c3, `gen_cluster.py:18,29`) : `vxlan-<vni>` est dessiné dans le `br-<subnet>` du netns du VPC. Le code crée **deux** bridges `br-<id>` (`internal/subnet/create.go:145-165`) : un dans le netns racine (vxlan + `v-<id>-e`), un dans le netns du VPC (`v-<id>-i`, `gw-`, tap). Ajouter le bridge côté hôte et le veth qui traverse la frontière. ### Mineur — réseau, doc et schémas - [ ] **B-6 — multi-cluster** (86923ea, `architecture-cluster.rst:27,47`) : préciser que le `bgp listen range` des RR doit couvrir l'underlay des deux clusters (aujourd'hui `rr1.conf` n'accepte que `192.168.14.0/24`), et que chaque cluster a un ASN de routeurs distinct (AS 65100 « valeur de production » vaut par cluster). Dépend de D2. - [ ] **B-7 — `gen_cluster.py:47,62`** : « AS 65000 » et « iBGP AS 64600 » côte à côte sans le `local-as 64600 no-prepend replace-as` (`route-reflector.rst:76`). - [ ] **B-8 — `gen_ensemble.py:181`** : la flèche du poste opérateur va directement à l'orchestrateur, alors que le texte dit « par Internet et les bordures (VNI 66001) », et croise les deux liens eBGP. - [ ] **B-9 — `architecture-cluster.rst:82,114`** : « du route reflector », « le route reflector qui les fait converger » au singulier. - [ ] **B-10** : `aria-label` de `gen_cluster.py:93` (« Architecture du cluster… ») ≠ alt RST (« Détail d'un cluster… ») ; `gen_ensemble.py:210` « routeurs du cluster » au singulier. - [ ] **B-13 — `architecture-cluster.rst:44` + note de `gen_ensemble.py`** : « les NAT » employé comme verbe → « les traduisent (NAT) ». ### Mineur — conventions - [ ] **B-11 — `gen_ensemble.py:81,91,97,104…`** : ~9 commentaires de section, contraires à la convention (`gen_cluster.py` n'en a aucun). - [ ] **B-12 — `suite/12-etats.sh:40-41`** : VPC au féminin (« vp-t12a supprimée », « recréée »). ### Mineur — scripts e2e - [ ] **B-14 — `lib/core.sh:62`** : `wait_state … deleted` réussit si l'API est injoignable (`curl -f` vide = supprimé) ; même faux positif dans `teardown_owned` / `delete_owned`. Distinguer 404 et échec de connexion via `api_code`. - [ ] **B-15 — `lib/evpn.sh:82-94,130-134`** : les `*_quiet` réussissent si `journalctl` échoue ; sans 2ᵉ argument, `watchdog_quiet` échoue toujours (latent). - [ ] **B-16 — `33-bridge.sh:24`, `23-metadonnees.sh:25,28,33-34`** : tests négatifs fondés sur une sortie vide de `vm_ssh` / `curl` ; un SSH en panne les fait passer (contraire à `lab.rst:464`). Vérifier d'abord le succès de la commande. - [ ] **B-17 — nettoyage hors `assert_clean`** : `/tmp/t21-*2.log`, `/tmp/t22-*.log`, `/tmp/t44.log`, `/tmp/t72.*`, `/var/tmp/e2e/t61.*` jamais supprimés ; netns `t02-ebt` non nettoyé avant recréation (`02-prerequis.sh:22`). - [ ] **B-18** (4e4ad7f) : `71-perte-rr.sh:61-65` ne vérifie pas le volume de requêtes émises et `END{print n,max}` n'a pas de `+0` (aligner sur `61-redemarrage-agent.sh:69`) ; `72-perte-switch.sh:41-45` coupe l'underlay de sw2 même si l'état VRRP est illisible. - [ ] **B-19 — `run.sh:104`** : `run.sh 4` lance silencieusement le seul 41 ; `run.sh dhcp-two` refusé alors que l'usage et `lab.rst:242` annoncent « par nom ». Exiger deux chiffres ou le nom exact. - [ ] **B-20 — `lab.rst:435`** : la liste de `core.sh` omet `known_flaky` ; `:455-463`, l'exemple vise une cible inexistante (10.98.1.10), contraire à la règle « la cible est vivante ». Note sans action : eeb77c3 mélange l'ajout des générateurs et la passe « VPC au masculin ». ## Ordre proposé 1. B-1, B-2, B-3, B-14 à B-19 : les faux positifs et dépendances cachées des e2e, avant toute nouvelle campagne. 2. A-H1 à A-H9 : commandes et API fausses dans la doc. 3. D1 à D4, puis les points qui en dépendent. 4. Le reste.
Author
Owner

Campagne de lab du 2026-10-24 — feature-80 (5f5a179 + scénario 72, commités depuis en 291ebf9 et 76d8169)

Serveur EM-B420E-NVME fr-par-1, suite complète run.sh --continue all, 13:37 → 14:40.

Scénarios Résultat
01-lab, 02-prerequis, 03-image 60 / 47 / 14 réussis
11-validation 46 réussis
12-etats 28 réussis, 1 échoué (voir plus bas)
21 à 28 tous verts (52, 54, 26, 16, 20, 21, 18, 31)
31 à 35 tous verts (44, 27, 52, 14, 25 + 3 connus)
41 à 44 tous verts (27, 17, 88, 28)
51 à 53 tous verts (55, 51, 26)
61, 62 tous verts (41, 54)
71, 72 tous verts (31, 18)

Points de #80 validés en lab :

  • Comptage des verdicts propre à chaque test : bilan par scénario, connus comptés à part, run en échec sur le seul échec réel.
  • 98_network_updates.cfg sous cloud-init 22.4 (Debian 12) : sans effet indésirable (03, 25, 27 verts).
  • 72-perte-switch assoupli : un seul maître VRRP à chaque étape ; sw2 coupé → sw1 maître (silence 3,1 s) ;
    sw2 rétabli → sw1 reste maître (préemption désactivée), plus long silence 0,2 s ; session EVPN vers
    10.255.255.2 jamais coupée (246 réponses pour 260 requêtes sur tout le scénario).

Échec de 12-etats — défaut de two, hors #80 : la VM t12-err est démarrée sur un disque absent ;
QEMU échoue (Could not open '/var/lib/two/volumes/t12-absent.qcow2') après avoir créé
/run/two/vms/monitor/t12-err.sock. La VM passe en error, sa suppression aboutit (DELETE 202 puis 404),
mais le socket reste : assert_clean le relève sur hv1. Ticket à part.

## Campagne de lab du 2026-10-24 — `feature-80` (`5f5a179` + scénario 72, commités depuis en `291ebf9` et `76d8169`) Serveur EM-B420E-NVME fr-par-1, suite complète `run.sh --continue all`, 13:37 → 14:40. | Scénarios | Résultat | |---|---| | 01-lab, 02-prerequis, 03-image | 60 / 47 / 14 réussis | | 11-validation | 46 réussis | | **12-etats** | 28 réussis, **1 échoué** (voir plus bas) | | 21 à 28 | tous verts (52, 54, 26, 16, 20, 21, 18, 31) | | 31 à 35 | tous verts (44, 27, 52, 14, 25 + 3 connus) | | 41 à 44 | tous verts (27, 17, 88, 28) | | 51 à 53 | tous verts (55, 51, 26) | | 61, 62 | tous verts (41, 54) | | 71, **72** | tous verts (31, **18**) | Points de #80 validés en lab : - **Comptage des verdicts propre à chaque test** : bilan par scénario, connus comptés à part, `run` en échec sur le seul échec réel. - **`98_network_updates.cfg` sous cloud-init 22.4 (Debian 12)** : sans effet indésirable (03, 25, 27 verts). - **72-perte-switch assoupli** : un seul maître VRRP à chaque étape ; sw2 coupé → sw1 maître (silence 3,1 s) ; sw2 rétabli → sw1 reste maître (préemption désactivée), plus long silence 0,2 s ; session EVPN vers 10.255.255.2 jamais coupée (246 réponses pour 260 requêtes sur tout le scénario). **Échec de 12-etats — défaut de two, hors #80** : la VM `t12-err` est démarrée sur un disque absent ; QEMU échoue (`Could not open '/var/lib/two/volumes/t12-absent.qcow2'`) après avoir créé `/run/two/vms/monitor/t12-err.sock`. La VM passe en `error`, sa suppression aboutit (DELETE 202 puis 404), mais le socket reste : `assert_clean` le relève sur hv1. Ticket à part.
Author
Owner

Fusionné dans main (c628e70), après la campagne de lab du 2026-10-24 (bilan ci-dessus). Échec 12-etats hors périmètre : #84.

Fusionné dans main (`c628e70`), après la campagne de lab du 2026-10-24 (bilan ci-dessus). Échec 12-etats hors périmètre : #84.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
syonad/two#80
No description provided.