Lab : extraire labctl dans son propre dépôt, garder test/e2e dans two #55
Labels
No labels
bug fix
feature implementation
new feature
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
syonad/two#55
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Suite de #50 : sortir de
twol'outil qui monte un lab, pour n'y garder que ce qui testetwo.Pourquoi
Le lab de #50 mélange deux choses :
serveur Scaleway loué à l'heure. Rien de propre à
twodans le principe ;two— topologies, configurations FRR et agent, scénarios s1 à s6, quiparlent l'API de l'agent.
Le premier n'est pas l'orchestrateur et n'a pas à suivre son cycle de vie : il déploie déjà une
release publiée (
release:dans la topologie), pas le code du dépôt. Le second, au contraire,doit vivre avec
twopour qu'une feature et son scénario arrivent dans le même commit.Première étape faite sur
feature-50(ab12484) : scénarios,node.shet topologies déplacéssous
test/e2e/(run.sh,lib/,scenarios/,topologies/).Découpage
twolabctltest/e2e/:run.sh,lib/node.sh,scenarios/,topologies/cmd/lab,internal/lab/*(topology, render, provision, machine)scripts/deploy.sh,scripts/bootstrap_kvm.sh(installation detwo)scripts/lab-host.shet ses tests (serveur Scaleway)docs/developpement/lab.rstinternal/lab/render/frrouting.gpg) ; usage de l'outil, topologie, rôlesPas d'allègement de
go.modà attendre : toutes les dépendances decmd/labsont déjà utiliséespar les binaires de
two.Ce que l'outil sait de
twoaujourd'huiÀ lever avant l'extraction, tant que tout est dans le même dépôt :
hypervisor—releaseobligatoire etagent(topology/validate.go,topology.go) ;deploy.shetbootstrap_kvm.shembarqués pargo:embed(
scripts/embed.go, seul utilisateur :render/seed.go) et lancés pardeploy.sh --noup_script -i -u <uplink> -t <release>;agent.ymldéposé dans/etc/two/agent.yml;agent.serviceattendu sur un hyperviseur(
machine/machine.go,services) ;two-labdanslab-host.sh(LAB_NAME,LAB_TAG,~/.config/two-lab/,~/.cache/two-lab/, description du serveur) et dansprovision.KeyLabel;lab-host.sh pushcompile./cmd/labdepuis le dépôt ;test/e2e/run.shtrouvelab-host.shpar../../scripts/lab-host.sh.Proposition
two, refactoring testé sur place) : un nœud déclare desfichiers à déposer et des commandes à lancer, dans l'ordre, plus les services à vérifier.
L'installation de
twodevient une provision écrite danstest/e2e/topologies/;release,agentet lego:embeddisparaissent de l'outil. Ordre actuel à préserver sur unhyperviseur :
deploy.sh, puis FRR.labctlau lieu detwo-lab, chemins locaux surchargeables commeaujourd'hui.
syonad/labctl, avec l'historique (git filter-repo --path …), releasesversionnées.
two: version delabctlépinglée danstest/e2e/;pushenvoie ce binaireau lieu de compiler ;
run.shtrouvelab-host.shparLAB_HOSTou lePATH. Suppressionde
cmd/lab,internal/lab,scripts/lab-host*.sh,scripts/embed.go; mise à jour delab.rstet duCLAUDE.md.À trancher
syonad/labctlproposé), et sa visibilité ;tworécupèrelabctl: binaire de release téléchargé et vérifié (SHA256SUMS),ou
go run …@<version>;topologyetrender— avant l'extraction ici,ou après dans
labctl. Les cheminsconf/lab/cités dans #54 sont désormaistest/e2e/topologies/.Hors périmètre
sur les hyperviseurs) — ticket à part ;
labctl, nécessaires à uneprochaine utilisation du lab.
Critère
labctlconstruit et teste seul, sans référence àtwo; danstwo,test/e2e/run.sh allrejoué sur un lab monté avec une release de
labctldonne le même résultat que surfeature-50(106/106) ;
go test ./...etsphinx-build -Wverts dans les deux dépôts.Analyse de risque
Avant le premier push, vérifier qu'aucun n'a contenu
scaleway.env, une clé SSH ou un jeton(aujourd'hui sous
~/.config/two-lab/, hors du dépôt).lab-host.shdécrit la façon de louer et préparer l'infrastructure Scaleway ;la visibilité du nouveau dépôt se choisit en connaissance de cause.
twodépendra d'un binairelabctlexterne pour ses testse2e — version épinglée et somme vérifiée, comme
deploy.shle fait pour les releases detwo.Décisions du 2026-10-05
labctl.seulement comme banc de test de
two.Conséquences
twodans l'outil (rôlehypervisor,release,agent,go:embed,agent.service), ni de défaut personnel(
two-lab,~/.config/two-lab/, projet Scaleway). La provision générique (étape 1) est lepréalable à l'extraction.
commits des fichiers gardés ; aucun ne doit avoir contenu
scaleway.env, une clé SSH ou unjeton.
two;twon'en garde que la partietest/e2e/.Ajouté à « À trancher »
lab-host.sh;labtournesur tout hôte Linux avec KVM. Rester ainsi (Scaleway en exemple, hôte quelconque documenté) ou
prévoir d'autres fournisseurs — à décider, sans l'ajouter au périmètre de ce ticket.
Besoin ajouté le 2026-10-05 — stockage partagé entre hyperviseurs
La migration à chaud des VM existera dans
twoà terme. Pour la tester, le lab devra fournir unsystème de fichiers accessible à tous les hyperviseurs — Ceph, NFS ou équivalent — où vivent
les disques des VM : la migration à chaud de QEMU suppose que source et destination voient le même
disque.
Pour
labctl, cela veut dire :À trancher : NFS (un nœud, simple, suffisant pour la migration) ou Ceph (plus proche d'une
production répartie, beaucoup plus lourd à monter dans un lab éphémère).
Hors périmètre de l'extraction elle-même : capacité future de
labctl, au même titre qu'EVPN surle routeur.
Décisions du 2026-10-12
two.lab-host; la doc indiqueque
labctltourne sur tout hôte Linux avec KVM. Pas d'autre fournisseur dans ce ticket.Pour garder l'ordre validé en lab sur un hyperviseur (migration réseau → FRR → agent), deux
crochets :
provisionavant FRR,post_provisionaprès. Le rôlehypervisor,release,agent, lego:embeddedeploy.shetagent.servicecodé endur disparaissent de l'outil ; l'installation de
twodevient une provision detest/e2e/topologies/.two: binaire de release delabctl, version épinglée danstest/e2e/,vérifié par
SHA256SUMS.labctl.Étape 1 (branche
feature-55)Provision générique dans
two, testée sur place, puis session de lab : même résultat attendu quesur
0.2.0rc008(s1–s9, 285/285).Bilan — extraction livrée
Dépôt syonad/labctl (public, PolyForm Noncommercial 1.0.0)
git filter-repo(internal/lab/→internal/,cmd/labctl), commits signés.switch/rr/host, champsprovision,post_provision,files(fichiers ou répertoires, gravés dans unfiles.isopar nœud),services; variablesLAB_NODE,LAB_UPLINK,LAB_FILES.examples/evpn-2hv/,LABCTL_BINpourpush, CI de tests et de release (linux/amd64, darwin/arm64,lab-host.sh,SHA256SUMS).0.1.0rc001publiée ; référence détaillée dansdocs/guide.md(reprise delab.rst).Dans two (branche
feature-55,8dc7721etefc9528, à fusionner)test/e2e/labctl.shépinglelabctl0.1.0rc001 : téléchargement delabctl_linux_amd64etlab-host.sh, vérifiés contre des sommes SHA-256 écrites dans le script, puislab-host.shlancé avecLABCTL_BIN.run.shpasse par lui.cmd/labctl,internal/labetscripts/lab-host*retirés ;lab.rstne garde que ce qui est propre à two (topologies, installation de two, scénarios, résultats).test/e2e/topologies/provision/;test/e2e/build.shcompile agent, dhcp et metadata pour tester l'arbre courant.Qualification en lab (2026-10-12,
evpn-3hv, une session) : release0.2.0rc008seule puis binaires locaux — 284/285 les deux fois. Le seul échec est leBroken pipedes9, signature connue de #57. Au second passage, l'agent en cours d'exécution (/proc/<pid>/exe) a la somme exacte du binaire compilé en local.Suites ouvertes : #64 (
--no-install-recommends), #65 (lab : arbre courant entier, sans release), #66 (images préparées), syonad/labctl#1 (somme SHA-512 épinglée). Prochaine étape : #54, désormais danslabctl.