diff --git a/cmd/lab/lifecycle.go b/cmd/labctl/lifecycle.go similarity index 81% rename from cmd/lab/lifecycle.go rename to cmd/labctl/lifecycle.go index c91205e..6bc6547 100644 --- a/cmd/lab/lifecycle.go +++ b/cmd/labctl/lifecycle.go @@ -46,7 +46,7 @@ func flags(name string, stderr io.Writer) (*flag.FlagSet, *string) { func lab(runDir string, plan string, stdout, stderr io.Writer) (machine.Lab, bool) { dir, err := filepath.Abs(runDir) if err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return machine.Lab{}, false } p, ok := load(plan, stderr) @@ -67,7 +67,7 @@ func lab(runDir string, plan string, stdout, stderr io.Writer) (machine.Lab, boo func current(runDir string, stdout, stderr io.Writer) (machine.Lab, bool) { saved := filepath.Join(runDir, topologyFile) if _, err := os.Stat(saved); err != nil { - fmt.Fprintf(stderr, "lab: no lab in %s: %v\n", runDir, err) + fmt.Fprintf(stderr, "labctl: no lab in %s: %v\n", runDir, err) return machine.Lab{}, false } return lab(runDir, saved, stdout, stderr) @@ -75,7 +75,7 @@ func current(runDir string, stdout, stderr io.Writer) (machine.Lab, bool) { func upCmd(args []string, stdout, stderr io.Writer) int { fs, runDir := flags("up", stderr) - cacheDir := fs.String("cache", defaultDir(".cache", "two-lab"), "image cache directory") + cacheDir := fs.String("cache", defaultDir(".cache", "labctl"), "image cache directory") timeout := fs.Duration("timeout", 20*time.Minute, "how long to wait for the nodes to be ready") if err := fs.Parse(args); err != nil || fs.NArg() != 1 { fs.Usage() @@ -83,7 +83,7 @@ func upCmd(args []string, stdout, stderr io.Writer) int { } cache, err := filepath.Abs(*cacheDir) if err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } @@ -94,11 +94,11 @@ func upCmd(args []string, stdout, stderr io.Writer) int { } running, err := previous.Running() if err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } if len(running) > 0 { - fmt.Fprintf(stderr, "lab: lab %s is still running in %s: 'lab down' first\n", previous.Plan.Name, previous.RunDir) + fmt.Fprintf(stderr, "labctl: lab %s is still running in %s: 'lab down' first\n", previous.Plan.Name, previous.RunDir) return 1 } } @@ -109,15 +109,15 @@ func upCmd(args []string, stdout, stderr io.Writer) int { } source, err := os.ReadFile(fs.Arg(0)) if err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } if err := os.MkdirAll(l.RunDir, 0o700); err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } if err := os.WriteFile(filepath.Join(l.RunDir, topologyFile), source, 0o600); err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } @@ -125,7 +125,7 @@ func upCmd(args []string, stdout, stderr io.Writer) int { defer stop() fetcher := provision.Fetcher{Client: &http.Client{}, CacheDir: cache} if err := l.Up(ctx, fetcher, *timeout); err != nil { - fmt.Fprintf(stderr, "lab: %v\nlab: started nodes keep running: 'lab status', 'lab down'\n", err) + fmt.Fprintf(stderr, "labctl: %v\nlab: started nodes keep running: 'lab status', 'lab down'\n", err) return 1 } return 0 @@ -142,7 +142,7 @@ func statusCmd(args []string, stdout, stderr io.Writer) int { return 1 } if err := l.Status(stdout); err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } return 0 @@ -159,7 +159,7 @@ func downCmd(args []string, stdout, stderr io.Writer) int { return 1 } if err := l.Down(context.Background()); err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } return 0 @@ -177,16 +177,16 @@ func sshCmd(args []string, stdout, stderr io.Writer) int { } argv, err := l.SSH(fs.Arg(0), isTerminal(os.Stdin), fs.Args()[1:]) if err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } path, err := exec.LookPath(argv[0]) if err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } if err := execve(path, argv, os.Environ()); err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } return 0 diff --git a/cmd/lab/main.go b/cmd/labctl/main.go similarity index 88% rename from cmd/lab/main.go rename to cmd/labctl/main.go index 90c2e50..b4bd2c9 100644 --- a/cmd/lab/main.go +++ b/cmd/labctl/main.go @@ -13,7 +13,7 @@ import ( "git.g3e.fr/syonad/two/internal/lab/topology" ) -const usage = `usage: lab [options] [dir] +const usage = `usage: labctl [options] [dir] plan validate the topology and print the deterministic plan: addresses, cables, ports @@ -36,7 +36,7 @@ const usage = `usage: lab [options] [dir] ssh [-run dir] [command...] open a shell on a node, or run a command on it, with the key generated by up - defaults: -run $HOME/lab-run, -cache $HOME/.cache/two-lab, -timeout 20m + defaults: -run $HOME/lab-run, -cache $HOME/.cache/labctl, -timeout 20m ` type keyFiles []string @@ -79,12 +79,12 @@ func run(args []string, stdout, stderr io.Writer) int { func load(path string, stderr io.Writer) (*topology.Plan, bool) { t, err := topology.Load(path) if err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return nil, false } p, err := topology.Compute(t) if err != nil { - fmt.Fprintf(stderr, "lab: %s:\n%v\n", path, err) + fmt.Fprintf(stderr, "labctl: %s:\n%v\n", path, err) return nil, false } return p, true @@ -96,7 +96,7 @@ func plan(path string, stdout, stderr io.Writer) int { return 1 } if err := p.Write(stdout); err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } return 0 @@ -122,27 +122,27 @@ func renderCmd(args []string, stdout, stderr io.Writer) int { } dir, err := filepath.Abs(fs.Arg(1)) if err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } authorized, err := readKeys(keys) if err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } opts := render.Options{RunDir: dir, AuthorizedKeys: authorized} if err := provision.ReadInputs(p, &opts); err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } nodes, err := render.Render(p, opts) if err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } for _, n := range nodes { if err := provision.WriteFiles(n); err != nil { - fmt.Fprintf(stderr, "lab: %v\n", err) + fmt.Fprintf(stderr, "labctl: %v\n", err) return 1 } fmt.Fprintf(stdout, "%s\n", n.Dir) diff --git a/cmd/lab/main_test.go b/cmd/labctl/main_test.go similarity index 97% rename from cmd/lab/main_test.go rename to cmd/labctl/main_test.go index cb78c26..4f87a51 100644 --- a/cmd/lab/main_test.go +++ b/cmd/labctl/main_test.go @@ -78,7 +78,7 @@ func TestRun_MissingFile(t *testing.T) { func TestRun_RenderWritesEveryNodeFiles(t *testing.T) { dir := t.TempDir() key := filepath.Join(dir, "lab.pub") - if err := os.WriteFile(key, []byte("# lab key\n\nssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFG/JMmjfko96WkJV8DiL6rip/H/q/R++y8s27Z+Cj6O two-lab-automation\n"), 0o600); err != nil { + if err := os.WriteFile(key, []byte("# lab key\n\nssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFG/JMmjfko96WkJV8DiL6rip/H/q/R++y8s27Z+Cj6O lab-automation\n"), 0o600); err != nil { t.Fatal(err) } out := filepath.Join(dir, "run") @@ -112,7 +112,7 @@ func TestRun_RenderWritesEveryNodeFiles(t *testing.T) { if err != nil { t.Fatal(err) } - if !strings.Contains(string(userData), "two-lab-automation") || strings.Contains(string(userData), "# lab key") { + if !strings.Contains(string(userData), "lab-automation") || strings.Contains(string(userData), "# lab key") { t.Errorf("keys not read as an authorized_keys file:\n%s", userData) } } @@ -157,7 +157,7 @@ func TestRun_CommandsWithoutALabInTheRunDir(t *testing.T) { args = append(args, "hv1") } code, _, stderr := runLab(args...) - if code != 1 || !strings.Contains(stderr, "lab: no lab in "+run) { + if code != 1 || !strings.Contains(stderr, "labctl: no lab in "+run) { t.Errorf("%s: code %d, stderr %q", cmd, code, stderr) } } @@ -304,7 +304,7 @@ func TestRun_UpRefusesToReplaceARunningLab(t *testing.T) { func TestRun_RenderShipsTheExampleFRRConfigs(t *testing.T) { dir := t.TempDir() key := filepath.Join(dir, "lab.pub") - if err := os.WriteFile(key, []byte("ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFG/JMmjfko96WkJV8DiL6rip/H/q/R++y8s27Z+Cj6O two-lab-automation\n"), 0o600); err != nil { + if err := os.WriteFile(key, []byte("ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFG/JMmjfko96WkJV8DiL6rip/H/q/R++y8s27Z+Cj6O lab-automation\n"), 0o600); err != nil { t.Fatal(err) } out := filepath.Join(dir, "run") diff --git a/cmd/lab/terminal.go b/cmd/labctl/terminal.go similarity index 100% rename from cmd/lab/terminal.go rename to cmd/labctl/terminal.go diff --git a/cmd/lab/terminal_darwin.go b/cmd/labctl/terminal_darwin.go similarity index 100% rename from cmd/lab/terminal_darwin.go rename to cmd/labctl/terminal_darwin.go diff --git a/cmd/lab/terminal_linux.go b/cmd/labctl/terminal_linux.go similarity index 100% rename from cmd/lab/terminal_linux.go rename to cmd/labctl/terminal_linux.go diff --git a/cmd/lab/terminal_other.go b/cmd/labctl/terminal_other.go similarity index 100% rename from cmd/lab/terminal_other.go rename to cmd/labctl/terminal_other.go diff --git a/docs/developpement/lab.rst b/docs/developpement/lab.rst index ff4e46b..ffe98ab 100644 --- a/docs/developpement/lab.rst +++ b/docs/developpement/lab.rst @@ -14,8 +14,8 @@ comment s'en servir. .. note:: État actuel : le lab de #50 est livré — serveur loué à l'heure (``scripts/lab-host.sh``), - topologie déclarative et plan déterministe (``lab plan``), VM rendues et lancées sur le - serveur (``lab render``, ``lab up`` / ``status`` / ``down`` / ``ssh``), rôles installés au + topologie déclarative et plan déterministe (``labctl plan``), VM rendues et lancées sur le + serveur (``labctl render``, ``labctl up`` / ``status`` / ``down`` / ``ssh``), rôles installés au démarrage (FRR sur le switch et le route reflector, two par ``deploy.sh`` sur les hyperviseurs) et scénarios versionnés (``test/e2e/run.sh``). La redondance du plan de contrôle — deux route reflectors, deux switchs — est l'objet de @@ -62,9 +62,9 @@ Prérequis côté Scaleway Fichiers locaux --------------- -Tout ce dont le script a besoin vit sous ``~/.config/two-lab/``, hors du dépôt. +Tout ce dont le script a besoin vit sous ``~/.config/labctl/``, hors du dépôt. -``~/.config/two-lab/scaleway.env`` +``~/.config/labctl/scaleway.env`` Identifiants Scaleway, une ligne ``CLÉ=valeur`` chacun : .. code-block:: bash @@ -82,7 +82,7 @@ Tout ce dont le script a besoin vit sous ``~/.config/two-lab/``, hors du dépôt Pour changer de clé, remplacer la ligne ``SCW_SECRET_KEY=`` ; rien d'autre à modifier. -``~/.config/two-lab/ssh/lab_ed25519`` +``~/.config/labctl/ssh/lab_ed25519`` Clé SSH dédiée au lab, **sans phrase de passe**, pour que les sessions tournent sans intervention. Sa partie publique doit être enregistrée dans le projet. Quand elle existe, le script l'utilise **seule** (``IdentitiesOnly``, agent désactivé) ; sinon il retombe sur @@ -94,10 +94,10 @@ Tout ce dont le script a besoin vit sous ``~/.config/two-lab/``, hors du dépôt .. code-block:: bash - mkdir -p ~/.config/two-lab/ssh && chmod 700 ~/.config/two-lab ~/.config/two-lab/ssh - ssh-keygen -t ed25519 -N '' -C two-lab-automation -f ~/.config/two-lab/ssh/lab_ed25519 + mkdir -p ~/.config/labctl/ssh && chmod 700 ~/.config/labctl ~/.config/labctl/ssh + ssh-keygen -t ed25519 -N '' -C lab-automation -f ~/.config/labctl/ssh/lab_ed25519 -``~/.cache/two-lab/`` +``~/.cache/labctl/`` État de la session en cours : adresse et utilisateur du serveur, ``known_hosts`` dédié. Vidé par ``down``. @@ -115,11 +115,11 @@ Commandes status liste les serveurs de lab du projet, dans toutes les zones candidates ssh [commande] se connecte au serveur de lab ; avec une commande, un terminal n'est demandé que si l'entrée standard en est un - prepare installe sur le serveur ce dont lab a besoin (qemu, genisoimage), vérifie + prepare installe sur le serveur ce dont labctl a besoin (qemu, genisoimage), vérifie /dev/kvm, la virtualisation imbriquée et un CPU x86-64-v3 ; lancé aussi par up - push compile cmd/lab pour linux/amd64 et dépose sur le serveur ~/lab et le + push compile cmd/labctl pour linux/amd64 et dépose sur le serveur ~/labctl et le répertoire de la topologie dans ~/topology/ (avec les fichiers qu'elle - référence) ; ensuite : ssh './lab up topology/' + référence) ; ensuite : ssh './labctl up topology/' down supprime tous les serveurs de lab du projet, dans toutes les zones candidates, et attend leur disparition session [cmd] up, puis la commande distante (ou un shell), puis down quoi qu'il arrive @@ -190,16 +190,16 @@ environ 100 secondes la première fois — d'où l'attente intégrée à ``up``. ``up``, ``ssh`` et ``down`` séparément servent au debug interactif — et laissent la suppression à la charge de l'utilisateur. -Une campagne sur le lab enchaîne ces commandes depuis le Mac ; ``lab`` s'exécute sur le serveur +Une campagne sur le lab enchaîne ces commandes depuis le Mac ; ``labctl`` s'exécute sur le serveur (voir `Lancement des VM`_) : .. code-block:: text scripts/lab-host.sh up scripts/lab-host.sh push test/e2e/topologies/evpn-2hv.yml - scripts/lab-host.sh ssh './lab up topology/evpn-2hv.yml' - scripts/lab-host.sh ssh './lab ssh hv1' # shell interactif sur hv1 - scripts/lab-host.sh ssh './lab ssh hv1 ip -br a' # commande, code de retour propagé + scripts/lab-host.sh ssh './labctl up topology/evpn-2hv.yml' + scripts/lab-host.sh ssh './labctl ssh hv1' # shell interactif sur hv1 + scripts/lab-host.sh ssh './labctl ssh hv1 ip -br a' # commande, code de retour propagé scripts/lab-host.sh down ``push`` transfère par la connexion SSH du script — mêmes options, même clé, même @@ -255,7 +255,7 @@ Ce que le fichier déclare : Ils voyagent dans un ``files.iso`` propre au nœud (volume ``LABFILES``), attaché comme second lecteur et recopié au premier démarrage : la taille n'est pas limitée par cloud-init, et un binaire de plusieurs dizaines de Mio passe ; - * ``services`` — les unités systemd que ``lab up`` vérifie actives sur le nœud. + * ``services`` — les unités systemd que ``labctl up`` vérifie actives sur le nœud. Les scripts reçoivent ``LAB_NODE`` (nom du nœud), ``LAB_UPLINK`` (interface de son premier segment, qui porte la route par défaut) et ``LAB_FILES`` (``/etc/lab/files``). L'outil ne sait @@ -288,15 +288,15 @@ Ce que l'outil en déduit, de façon déterministe — même fichier, même plan .. warning:: Réordonner les nœuds ou les segments dans le fichier **change les adresses, les MAC et les - ports**. C'est assumé pour un lab ; ``lab plan`` montre le résultat avant tout lancement. + ports**. C'est assumé pour un lab ; ``labctl plan`` montre le résultat avant tout lancement. Limites : 1000 nœuds, 256 segments, et autant de câbles que la plage UDP le permet (22 768). -``lab plan`` valide le fichier et affiche le plan, sans rien lancer : +``labctl plan`` valide le fichier et affiche le plan, sans rien lancer : .. code-block:: text - $ go run ./cmd/lab plan test/e2e/topologies/evpn-2hv.yml + $ go run ./cmd/labctl plan test/e2e/topologies/evpn-2hv.yml lab evpn-2hv: nodes 4, segments 1, cables 3 nodes @@ -324,8 +324,8 @@ champs inconnus et les clés en double sont refusés aussi : .. code-block:: text - $ lab plan cassee.yml - lab: cassee.yml: + $ labctl plan cassee.yml + labctl: cassee.yml: segment underlay: rr1 is a rr, not a switch segment underlay: cidr 10.250.0.0/31 prefix length out of range [/8, /30] node sw1: switch carries no segment @@ -356,7 +356,7 @@ dépose le ``frr.conf`` du nœud et redémarre FRR. La mise à jour des index de pendant cinq minutes : un nœud peut démarrer avant que le switch, par lequel il sort, n'ait posé son NAT. -La **clé du dépôt FRR** n'est pas téléchargée au démarrage : elle est enregistrée dans ``lab`` +La **clé du dépôt FRR** n'est pas téléchargée au démarrage : elle est enregistrée dans ``labctl`` (``internal/lab/render/frrouting.gpg``) et déposée par cloud-init. Elle a été récupérée le 2026-10-04 sur ``deb.frrouting.org`` ; les empreintes de ses clés primaires sont publiées sous la même valeur sur ``keys.openpgp.org`` et ``keyserver.ubuntu.com`` : @@ -401,7 +401,7 @@ le répertoire : le lab suivant teste la release seule. test/e2e/build.sh # binaires de l'arbre courant scripts/lab-host.sh push test/e2e/topologies/evpn-3hv.yml - scripts/lab-host.sh ssh './lab up topology/evpn-3hv.yml' + scripts/lab-host.sh ssh './labctl up topology/evpn-3hv.yml' test/e2e/build.sh --clean # retour à la release seule FRR est installé **après** la provision : il démarre sur le réseau final. Démarré @@ -418,7 +418,7 @@ FRR installé avec succès passerait pour un démarrage réussi. Chaque nœud re de la loopback, ``provision``, FRR, ``post_provision`` ; ``runcmd`` n'appelle que lui, et la première étape en échec met cloud-init en erreur. -**Ce que vérifie** ``lab up``, une fois cloud-init terminé sans erreur : les ``services`` déclarés +**Ce que vérifie** ``labctl up``, une fois cloud-init terminé sans erreur : les ``services`` déclarés par chaque nœud (``agent.service`` sur les hyperviseurs), et ``frr`` sur chaque nœud qui en a un. Ce contrôle couvre ce que cloud-init ne voit pas — si la migration réseau échoue, ``deploy.sh`` arme un redémarrage de secours, et la VM redémarrée ne rejoue pas ``runcmd``. @@ -428,13 +428,13 @@ secours, et la VM redémarrée ne rejoue pas ``runcmd``. **Un hyperviseur du lab ne survit pas à un redémarrage.** En production, la racine est en tmpfs et ``deploy.sh --bootstrap`` est rejoué à chaque démarrage ; dans le lab, ``-i`` n'est exécuté qu'au premier, et la migration réseau, qui n'est pas persistée, est perdue. Recréer le - lab : ``lab down`` puis ``lab up``. + lab : ``labctl down`` puis ``labctl up``. Vérifié le 2026-10-04 sur le serveur de lab, topologie ``evpn-2hv``, release ``0.2.0rc002`` : .. code-block:: text - $ scripts/lab-host.sh ssh './lab up -timeout 25m topology/evpn-2hv.yml' + $ scripts/lab-host.sh ssh './labctl up -timeout 25m topology/evpn-2hv.yml' sw1: started rr1: started hv1: started @@ -450,7 +450,7 @@ Vérifié le 2026-10-04 sur le serveur de lab, topologie ``evpn-2hv``, release ` * - Vérification - Résultat - * - ``lab up`` complet : FRR, ``deploy.sh`` et vérification des services de chaque rôle + * - ``labctl up`` complet : FRR, ``deploy.sh`` et vérification des services de chaque rôle - 6 min 15 * - session switch ↔ route reflector, IPv4 unicast, BFD - Established, BFD up ; le switch reçoit la seule loopback du route reflector @@ -481,11 +481,11 @@ Vérifié le 2026-10-04 sur le serveur de lab, topologie ``evpn-2hv``, release ` Rendu des VM ------------ -``lab render`` produit, pour chaque nœud, ce qu'il faut pour démarrer sa VM — sans rien lancer : +``labctl render`` produit, pour chaque nœud, ce qu'il faut pour démarrer sa VM — sans rien lancer : .. code-block:: text - $ go run ./cmd/lab render -key ~/.config/two-lab/ssh/lab_ed25519.pub test/e2e/topologies/evpn-2hv.yml + $ go run ./cmd/labctl render -key ~/.config/labctl/ssh/lab_ed25519.pub test/e2e/topologies/evpn-2hv.yml ``//`` reçoit : @@ -547,7 +547,7 @@ Vérifié sur de vraies VM Le switch et le route reflector n'ont pas besoin de KVM imbriqué : ``sw1`` et ``rr1`` de l'exemple ont été démarrés **sur un Mac**, en émulation (TCG), avec Debian 12 ``generic`` et -les fichiers produits par ``lab render``. +les fichiers produits par ``labctl render``. .. list-table:: :header-rows: 1 @@ -586,7 +586,7 @@ Reste à vérifier sur le serveur de lab : les hyperviseurs, qui exigent KVM imb Lancement des VM ---------------- -``lab`` s'exécute **sur le serveur de lab**. Il garde l'état du lab dans un répertoire +``labctl`` s'exécute **sur le serveur de lab**. Il garde l'état du lab dans un répertoire (``-run``, par défaut ``~/lab-run``) : ``status``, ``down`` et ``ssh`` n'ont donc pas besoin de la topologie. @@ -597,13 +597,13 @@ topologie. lab down [-run dir] lab ssh [-run dir] [commande…] -``lab up`` +``labctl up`` 1. refuse de continuer si un lab tourne déjà dans le répertoire ; - 2. télécharge chaque image dans le cache (``-cache``, par défaut ``~/.cache/two-lab``) et la + 2. télécharge chaque image dans le cache (``-cache``, par défaut ``~/.cache/labctl``) et la vérifie contre ``SHA512SUMS`` ; une image déjà présente et toujours conforme n'est pas retéléchargée, la liste des sommes est relue à chaque fois ; 3. génère une paire de clés SSH dans le répertoire du lab, si elle n'existe pas encore ; - 4. pour chaque nœud : fichiers de ``lab render``, disque **neuf** en overlay qcow2 sur + 4. pour chaque nœud : fichiers de ``labctl render``, disque **neuf** en overlay qcow2 sur l'image (``qemu-img create -b``, 20 Gio annoncés), image ``cidata`` (``genisoimage``) ; 5. démarre les QEMU, **switchs d'abord**, détachés (``-daemonize``) : ils survivent à la session SSH qui les a lancés ; @@ -611,35 +611,35 @@ topologie. jusqu'au délai ``-timeout``. La topologie est copiée dans ``/topology.yml``. Un échec laisse les nœuds démarrés en - place : ``lab status``, puis ``lab down``. + place : ``labctl status``, puis ``labctl down``. -``lab status`` +``labctl status`` Pour chaque nœud : rôle, état du processus QEMU, PID, port SSH sur la boucle locale. -``lab down`` +``labctl down`` Arrête chaque QEMU par ``SIGTERM``, puis ``SIGKILL`` au bout de 30 s. Les disques sont conservés jusqu'au prochain ``up``, qui les recrée. -``lab ssh`` - Ouvre un shell sur un nœud, ou y exécute une commande, avec la clé générée par ``up``. ``lab`` +``labctl ssh`` + Ouvre un shell sur un nœud, ou y exécute une commande, avec la clé générée par ``up``. ``labctl`` cède la place à ``ssh``, dont le code de retour est donc celui de la commande. Un terminal - n'est demandé (``-t``) que si l'entrée de ``lab`` en est un : depuis un script, ni + n'est demandé (``-t``) que si l'entrée de ``labctl`` en est un : depuis un script, ni pseudo-terminal ni ``\r\n`` dans la sortie. - Comme ``ssh``, ``lab ssh`` recolle ses arguments par des espaces et les confie à un shell + Comme ``ssh``, ``labctl ssh`` recolle ses arguments par des espaces et les confie à un shell distant — et depuis le Mac, il y en a **deux** : celui du serveur, puis celui de la VM. Une commande qui contient elle-même des guillemets se passe en une seule chaîne : .. code-block:: text - $ echo | scripts/lab-host.sh ssh './lab ssh hv1 sh -c "exit 42"'; echo "rc 42=$?" + $ echo | scripts/lab-host.sh ssh './labctl ssh hv1 sh -c "exit 42"'; echo "rc 42=$?" rc 42=0 - $ echo | scripts/lab-host.sh ssh "./lab ssh hv1 'sh -c \"exit 42\"'"; echo "rc 42=$?" + $ echo | scripts/lab-host.sh ssh "./labctl ssh hv1 'sh -c \"exit 42\"'"; echo "rc 42=$?" rc 42=42 Dans le premier cas, la VM reçoit ``sh -c exit 42`` : ``exit`` sans argument, ``42`` en ``$0``. Pour plus d'une commande, passer un script sur l'entrée standard : - ``scripts/lab-host.sh ssh "./lab ssh hv1 'sudo bash -s'" < script.sh``. + ``scripts/lab-host.sh ssh "./labctl ssh hv1 'sudo bash -s'" < script.sh``. Un processus n'est tenu pour celui d'un nœud que si son PID, lu dans ``qemu.pid``, désigne un processus vivant dont la ligne de commande (``/proc//cmdline``) contient ``-name ``. @@ -667,7 +667,7 @@ Une campagne réelle, de la création du serveur à la première commande sur un $ scripts/lab-host.sh push test/e2e/topologies/evpn-2hv.yml == compilation de lab (linux/amd64) == déposés sur le serveur : ~/lab, ~/evpn-2hv.yml — ensuite : lab-host.sh ssh './lab up evpn-2hv.yml' - $ scripts/lab-host.sh ssh './lab up evpn-2hv.yml' + $ scripts/lab-host.sh ssh './labctl up evpn-2hv.yml' sw1: started rr1: started hv1: started @@ -676,14 +676,14 @@ Une campagne réelle, de la création du serveur à la première commande sur un rr1: ready hv1: ready hv2: ready - $ scripts/lab-host.sh ssh './lab status' + $ scripts/lab-host.sh ssh './labctl status' node role state pid ssh sw1 switch running 5158 127.0.0.1:2200 rr1 rr running 5171 127.0.0.1:2201 hv1 hypervisor running 5182 127.0.0.1:2202 hv2 hypervisor running 5196 127.0.0.1:2203 -``lab up`` a pris **49 secondes**, téléchargement et vérification de l'image (427 Mio) compris ; +``labctl up`` a pris **49 secondes**, téléchargement et vérification de l'image (427 Mio) compris ; l'essentiel du temps d'une campagne est la livraison du serveur (environ 25 minutes avec ``prepare``). @@ -713,17 +713,17 @@ Le 2026-10-04, sur un Xeon E5-2640 v3, Debian 12 et QEMU 7.2 sur le serveur, top - présent, ``Y`` * - racine de hv1 (overlay de 20 Gio) - 20 Go : ``growpart`` agrandit la partition au premier démarrage - * - code de retour à travers ``lab-host.sh ssh`` et ``lab ssh``, sans terminal + * - code de retour à travers ``lab-host.sh ssh`` et ``labctl ssh``, sans terminal - propagé jusqu'au Mac - * - ``scripts/lab-host.sh ssh './lab ssh hv1'`` depuis un terminal + * - ``scripts/lab-host.sh ssh './labctl ssh hv1'`` depuis un terminal - shell interactif - * - ``lab down`` puis ``lab up`` d'une autre topologie + * - ``labctl down`` puis ``labctl up`` d'une autre topologie - conforme Scénarios --------- -Les scénarios se lancent **depuis le Mac**, sur un lab démarré (``up``, ``push``, ``./lab up``) : +Les scénarios se lancent **depuis le Mac**, sur un lab démarré (``up``, ``push``, ``./labctl up``) : .. code-block:: text @@ -906,7 +906,7 @@ Les VM sont accessibles depuis le netns de leur VPC, sur l'hyperviseur, avec l'u .. code-block:: text - scripts/lab-host.sh ssh "./lab ssh hv1 'sudo ip netns exec vp-s4 ssh -i /root/.ssh/lab-vm syonad@10.240.1.10'" + scripts/lab-host.sh ssh "./labctl ssh hv1 'sudo ip netns exec vp-s4 ssh -i /root/.ssh/lab-vm syonad@10.240.1.10'" Écrire un scénario ~~~~~~~~~~~~~~~~~~ @@ -965,7 +965,7 @@ Ce que le script garantit : création. La CLI ``scw`` n'est pas utilisée pour cette raison : son ``server create type=…`` choisit l'offre par son seul nom et peut tomber sur la mensuelle, qui engage un mois ; * il refuse de créer un second serveur si un serveur de lab existe déjà ; -* ``down`` agit sur **tous** les serveurs portant le tag ``two-lab`` dans le projet, et +* ``down`` agit sur **tous** les serveurs portant le tag ``labctl`` dans le projet, et ``session`` y ajoute l'identifiant reçu à la création : un serveur créé juste avant une interruption est rattrapé ; * une suppression refusée pendant la livraison ou l'installation est réessayée tant qu'elle dure, @@ -1020,10 +1020,10 @@ Sécurité production. * Une clé secrète qui a circulé ailleurs que dans ``scaleway.env`` (conversation, terminal partagé, capture d'écran) se régénère. -* **Clé SSH des VM** : générée par ``lab up`` sur le serveur, c'est la seule clé autorisée dans +* **Clé SSH des VM** : générée par ``labctl up`` sur le serveur, c'est la seule clé autorisée dans les VM. Elle ne quitte jamais le serveur, n'ouvre que les VM du lab — qui n'écoutent qu'en boucle locale — et disparaît avec lui. La clé publique du Mac n'est jamais envoyée aux VM. -* **Clés d'hôte des VM non vérifiées** par ``lab ssh`` (``known_hosts`` jetable) : elles changent +* **Clés d'hôte des VM non vérifiées** par ``labctl ssh`` (``known_hosts`` jetable) : elles changent à chaque ``up``. Acceptable uniquement parce que la connexion reste sur la boucle locale d'un serveur auquel on s'est authentifié. * **Code exécuté sans épinglage par** ``deploy.sh`` : la bibliothèque ``shflags`` est récupérée @@ -1041,7 +1041,7 @@ Tests bash scripts/lab-host_test.sh bash test/e2e/run_test.sh - go test ./internal/lab/... ./cmd/lab/ + go test ./internal/lab/... ./cmd/labctl/ Environ une minute et demie, sans réseau : la suite remplace ``curl`` par une fausse API Scaleway qui se place dans le pire cas (offre mensuelle listée avant l'horaire, serveurs d'autres projets, diff --git a/internal/lab/machine/machine_test.go b/internal/lab/machine/machine_test.go index abb7575..651b319 100644 --- a/internal/lab/machine/machine_test.go +++ b/internal/lab/machine/machine_test.go @@ -24,7 +24,7 @@ import ( "git.g3e.fr/syonad/two/internal/lab/topology" ) -const labKey = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFG/JMmjfko96WkJV8DiL6rip/H/q/R++y8s27Z+Cj6O two-lab" +const labKey = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFG/JMmjfko96WkJV8DiL6rip/H/q/R++y8s27Z+Cj6O labctl" type exitErr int diff --git a/internal/lab/provision/provision.go b/internal/lab/provision/provision.go index fe20c9f..4613fb1 100644 --- a/internal/lab/provision/provision.go +++ b/internal/lab/provision/provision.go @@ -16,7 +16,7 @@ import ( const ( KeyFile = "lab_ed25519" - KeyLabel = "two-lab" + KeyLabel = "labctl" DiskSize = "20G" SeedLabel = "cidata" diff --git a/internal/lab/provision/provision_test.go b/internal/lab/provision/provision_test.go index a837f05..057f529 100644 --- a/internal/lab/provision/provision_test.go +++ b/internal/lab/provision/provision_test.go @@ -15,7 +15,7 @@ import ( "git.g3e.fr/syonad/two/internal/lab/topology" ) -const generatedKey = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFG/JMmjfko96WkJV8DiL6rip/H/q/R++y8s27Z+Cj6O two-lab" +const generatedKey = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFG/JMmjfko96WkJV8DiL6rip/H/q/R++y8s27Z+Cj6O labctl" type fakeRunner struct { calls [][]string @@ -98,7 +98,7 @@ func TestPrepare_StagesEveryNode(t *testing.T) { base := filepath.Join(cache, "debian12", "debian-12-generic-amd64.qcow2") want := [][]string{ - {"ssh-keygen", "-q", "-t", "ed25519", "-N", "", "-C", "two-lab", "-f", filepath.Join(run, "lab_ed25519")}, + {"ssh-keygen", "-q", "-t", "ed25519", "-N", "", "-C", "labctl", "-f", filepath.Join(run, "lab_ed25519")}, } for _, n := range []string{"sw1", "rr1", "hv1", "hv2"} { dir := filepath.Join(run, n) @@ -332,7 +332,7 @@ func TestEnsureKey_WithTheRealSSHKeygen(t *testing.T) { if err != nil { t.Fatalf("EnsureKey: %v", err) } - if !strings.HasPrefix(key, "ssh-ed25519 ") || !strings.HasSuffix(key, " two-lab") { + if !strings.HasPrefix(key, "ssh-ed25519 ") || !strings.HasSuffix(key, " labctl") { t.Errorf("key = %q", key) } info, err := os.Stat(filepath.Join(dir, "lab_ed25519")) diff --git a/internal/lab/render/render_test.go b/internal/lab/render/render_test.go index fd6ea47..3f38a41 100644 --- a/internal/lab/render/render_test.go +++ b/internal/lab/render/render_test.go @@ -10,7 +10,7 @@ import ( "git.g3e.fr/syonad/two/internal/lab/topology" ) -const labKey = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFG/JMmjfko96WkJV8DiL6rip/H/q/R++y8s27Z+Cj6O two-lab-automation" +const labKey = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIFG/JMmjfko96WkJV8DiL6rip/H/q/R++y8s27Z+Cj6O lab-automation" const twoHypervisors = `name: evpn-2hv images: diff --git a/scripts/lab-host.sh b/scripts/lab-host.sh index 5072f5f..db1e985 100755 --- a/scripts/lab-host.sh +++ b/scripts/lab-host.sh @@ -1,21 +1,21 @@ #!/usr/bin/env bash API_URL="${SCW_API_URL:-https://api.scaleway.com}" -CREDENTIALS_FILE="${LAB_CREDENTIALS_FILE:-${HOME}/.config/two-lab/scaleway.env}" +CREDENTIALS_FILE="${LAB_CREDENTIALS_FILE:-${HOME}/.config/labctl/scaleway.env}" OFFER_NAME="${LAB_OFFER:-EM-B420E-NVME}" ALL_ZONES="fr-par-1 fr-par-2 nl-ams-1 nl-ams-2 pl-waw-2 pl-waw-3" OS_NAME="${LAB_OS_NAME:-Debian}" OS_VERSION="${LAB_OS_VERSION:-12}" -LAB_NAME="${LAB_NAME:-two-lab}" -LAB_TAG="${LAB_TAG:-two-lab}" +LAB_NAME="${LAB_NAME:-labctl}" +LAB_TAG="${LAB_TAG:-labctl}" INSTALL_TIMEOUT="${LAB_INSTALL_TIMEOUT:-3600}" DELETE_TIMEOUT="${LAB_DELETE_TIMEOUT:-900}" SSH_TIMEOUT="${LAB_SSH_TIMEOUT:-600}" POLL_INTERVAL="${LAB_POLL_INTERVAL:-20}" HTTP_CONNECT_TIMEOUT="${LAB_HTTP_CONNECT_TIMEOUT:-10}" HTTP_TIMEOUT="${LAB_HTTP_TIMEOUT:-60}" -STATE_DIR="${LAB_STATE_DIR:-${HOME}/.cache/two-lab}" -SSH_KEY="${LAB_SSH_KEY:-${HOME}/.config/two-lab/ssh/lab_ed25519}" +STATE_DIR="${LAB_STATE_DIR:-${HOME}/.cache/labctl}" +SSH_KEY="${LAB_SSH_KEY:-${HOME}/.config/labctl/ssh/lab_ed25519}" REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" CREATED_ID="" @@ -34,11 +34,11 @@ usage: ${0##*/} [arguments] status liste les serveurs de lab du projet, dans toutes les zones candidates ssh [commande] se connecte au serveur de lab ; avec une commande, un terminal n'est demandé que si l'entrée standard en est un - prepare installe sur le serveur ce dont lab a besoin (qemu, genisoimage), vérifie + prepare installe sur le serveur ce dont labctl a besoin (qemu, genisoimage), vérifie /dev/kvm, la virtualisation imbriquée et un CPU x86-64-v3 ; lancé aussi par up - push compile cmd/lab pour linux/amd64 et dépose sur le serveur ~/lab et le + push compile cmd/labctl pour linux/amd64 et dépose sur le serveur ~/labctl et le répertoire de la topologie dans ~/topology/ (avec les fichiers qu'elle - référence) ; ensuite : ssh './lab up topology/' + référence) ; ensuite : ssh './labctl up topology/' down supprime tous les serveurs de lab du projet, dans toutes les zones candidates, et attend leur disparition session [cmd] up, puis la commande distante (ou un shell), puis down quoi qu'il arrive @@ -170,7 +170,7 @@ build_request () { local KEYS="${3}" jq -nc --argjson offer "${OFFER}" --argjson os "${OS}" --argjson keys "${KEYS}" \ --arg project "${PROJECT_ID}" --arg name "${LAB_NAME}" --arg tag "${LAB_TAG}" \ - '{offer_id: $offer.id, project_id: $project, name: $name, description: "lab two (#50)", + '{offer_id: $offer.id, project_id: $project, name: $name, description: "labctl", tags: [$tag], install: {os_id: $os.id, hostname: $name, ssh_key_ids: $keys}}' } @@ -383,17 +383,17 @@ push_dir () { cmd_push () { local TOPOLOGY="${1:-}" local NAME="${TOPOLOGY##*/}" - local BINARY="${STATE_DIR}/lab" + local BINARY="${STATE_DIR}/labctl" [[ $# -eq 1 && -n "${TOPOLOGY}" ]] || usage [[ -f "${TOPOLOGY}" ]] || die "topologie introuvable : ${TOPOLOGY}" [[ "${NAME}" =~ ^[A-Za-z0-9._-]+$ ]] || die "nom de topologie refusé : ${NAME} (lettres, chiffres, '.', '_', '-')" require_known_server - info "compilation de lab (linux/amd64)" - (cd "${REPO_DIR}" && CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o "${BINARY}" ./cmd/lab) \ - || die "compilation de lab échouée" - push_file "${BINARY}" lab 755 || die "envoi de lab échoué" + info "compilation de labctl (linux/amd64)" + (cd "${REPO_DIR}" && CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o "${BINARY}" ./cmd/labctl) \ + || die "compilation de labctl échouée" + push_file "${BINARY}" labctl 755 || die "envoi de labctl échoué" push_dir "$(dirname "${TOPOLOGY}")" || die "envoi du répertoire de ${NAME} échoué" - info "déposés sur le serveur : ~/lab, ~/topology/ — ensuite : ${0##*/} ssh './lab up topology/${NAME}'" + info "déposés sur le serveur : ~/labctl, ~/topology/ — ensuite : ${0##*/} ssh './labctl up topology/${NAME}'" } delete_server () { diff --git a/scripts/lab-host_test.sh b/scripts/lab-host_test.sh index 8e8d848..ea9ec85 100755 --- a/scripts/lab-host_test.sh +++ b/scripts/lab-host_test.sh @@ -193,7 +193,7 @@ base_state () { ], keys: [{id: "key-1", disabled: false}, {id: "key-off", disabled: true}], servers: { - "foreign-1": {id: "foreign-1", name: "prod-db", project_id: $o, tags: ["two-lab"], status: "ready", install: {status: "completed"}, ips: []}, + "foreign-1": {id: "foreign-1", name: "prod-db", project_id: $o, tags: ["labctl"], status: "ready", install: {status: "completed"}, ips: []}, "foreign-2": {id: "foreign-2", name: "autre", project_id: $p, tags: ["autre"], status: "ready", install: {status: "completed"}, ips: []} } }' @@ -305,16 +305,16 @@ test_up_creates_and_waits_for_installation () { mutate '.progress = [["delivering","to_install"],["ready","installing"],["ready","completed"]]' run_lab up || fail "code de sortie $?" [[ $(jq -r '.offer_id' "${WORK}/create.json") == "${HOURLY_ID}" ]] || fail "offre créée incorrecte" - [[ $(jq -r '.tags | join(",")' "${WORK}/create.json") == "two-lab" ]] || fail "tag absent" + [[ $(jq -r '.tags | join(",")' "${WORK}/create.json") == "labctl" ]] || fail "tag absent" [[ $(jq -r '.project_id' "${WORK}/create.json") == "${PROJECT}" ]] || fail "projet incorrect" - [[ $(cat "${WORK}/.cache/two-lab/ip" 2>/dev/null) == "203.0.113.7" ]] || fail "IPv4 non retenue" - [[ $(cat "${WORK}/.cache/two-lab/user" 2>/dev/null) == "debian" ]] || fail "utilisateur non retenu" + [[ $(cat "${WORK}/.cache/labctl/ip" 2>/dev/null) == "203.0.113.7" ]] || fail "IPv4 non retenue" + [[ $(cat "${WORK}/.cache/labctl/user" 2>/dev/null) == "debian" ]] || fail "utilisateur non retenu" teardown } test_up_refuses_when_lab_server_exists () { setup "up : refus si un serveur de lab existe déjà" - mutate '.servers["srv-old"] = {id: "srv-old", name: "two-lab", project_id: "'"${PROJECT}"'", tags: ["two-lab"], status: "ready", install: {status: "completed"}, ips: []}' + mutate '.servers["srv-old"] = {id: "srv-old", name: "labctl", project_id: "'"${PROJECT}"'", tags: ["labctl"], status: "ready", install: {status: "completed"}, ips: []}' run_lab up && fail "up a réussi" grep -q "^POST" "${WORK}/calls.log" && fail "second serveur créé" teardown @@ -331,7 +331,7 @@ test_secret_never_in_argv () { test_down_deletes_only_lab_servers_of_project () { setup "down : ne supprime que les serveurs de lab du projet" - mutate '.servers["srv-lab"] = {id: "srv-lab", name: "two-lab", project_id: "'"${PROJECT}"'", tags: ["two-lab"], status: "ready", install: {status: "completed"}, ips: []}' + mutate '.servers["srv-lab"] = {id: "srv-lab", name: "labctl", project_id: "'"${PROJECT}"'", tags: ["labctl"], status: "ready", install: {status: "completed"}, ips: []}' run_lab down || fail "code de sortie $?" [[ $(remaining) == "foreign-1,foreign-2" ]] || fail "restants : $(remaining)" teardown @@ -339,7 +339,7 @@ test_down_deletes_only_lab_servers_of_project () { test_down_retries_refused_deletion () { setup "down : réessaie une suppression refusée" - mutate '.delete_refusals = 2 | .servers["srv-lab"] = {id: "srv-lab", name: "two-lab", project_id: "'"${PROJECT}"'", tags: ["two-lab"], status: "ready", install: {status: "installing"}, ips: []}' + mutate '.delete_refusals = 2 | .servers["srv-lab"] = {id: "srv-lab", name: "labctl", project_id: "'"${PROJECT}"'", tags: ["labctl"], status: "ready", install: {status: "installing"}, ips: []}' run_lab down || fail "code de sortie $?" [[ $(grep -c "^DELETE" "${WORK}/calls.log") -eq 3 ]] || fail "$(grep -c "^DELETE" "${WORK}/calls.log") DELETE au lieu de 3" [[ $(remaining) == "foreign-1,foreign-2" ]] || fail "restants : $(remaining)" @@ -348,7 +348,7 @@ test_down_retries_refused_deletion () { test_down_fails_loudly_when_deletion_keeps_failing () { setup "down : échec bruyant si la suppression n'aboutit jamais" - mutate '.delete_refusals = 1000 | .servers["srv-lab"] = {id: "srv-lab", name: "two-lab", project_id: "'"${PROJECT}"'", tags: ["two-lab"], status: "ready", install: {status: "installing"}, ips: []}' + mutate '.delete_refusals = 1000 | .servers["srv-lab"] = {id: "srv-lab", name: "labctl", project_id: "'"${PROJECT}"'", tags: ["labctl"], status: "ready", install: {status: "installing"}, ips: []}' LAB_DELETE_TIMEOUT=1 run_lab down && fail "down a réussi" grep -q "TOUJOURS FACTURÉ" "${WORK}/out.log" || fail "pas d'alerte de facturation" teardown @@ -356,7 +356,7 @@ test_down_fails_loudly_when_deletion_keeps_failing () { test_down_waits_until_server_is_gone () { setup "down : attend que le serveur ait disparu" - mutate '.linger = 3 | .servers["srv-lab"] = {id: "srv-lab", name: "two-lab", project_id: "'"${PROJECT}"'", tags: ["two-lab"], status: "ready", install: {status: "completed"}, ips: []}' + mutate '.linger = 3 | .servers["srv-lab"] = {id: "srv-lab", name: "labctl", project_id: "'"${PROJECT}"'", tags: ["labctl"], status: "ready", install: {status: "completed"}, ips: []}' run_lab down || fail "code de sortie $?" [[ $(grep -c "^GET /baremetal/v1/zones/fr-par-1/servers/srv-lab$" "${WORK}/calls.log") -ge 4 ]] || fail "disparition non attendue" [[ $(remaining) == "foreign-1,foreign-2" ]] || fail "restants : $(remaining)" @@ -365,7 +365,7 @@ test_down_waits_until_server_is_gone () { test_down_fails_loudly_when_server_never_disappears () { setup "down : échec bruyant si le serveur ne disparaît jamais" - mutate '.linger = 100000 | .servers["srv-lab"] = {id: "srv-lab", name: "two-lab", project_id: "'"${PROJECT}"'", tags: ["two-lab"], status: "ready", install: {status: "completed"}, ips: []}' + mutate '.linger = 100000 | .servers["srv-lab"] = {id: "srv-lab", name: "labctl", project_id: "'"${PROJECT}"'", tags: ["labctl"], status: "ready", install: {status: "completed"}, ips: []}' LAB_DELETE_TIMEOUT=1 run_lab down && fail "down a réussi" grep -q "TOUJOURS FACTURÉ" "${WORK}/out.log" || fail "pas d'alerte de facturation" teardown @@ -373,7 +373,7 @@ test_down_fails_loudly_when_server_never_disappears () { test_down_does_not_mistake_api_error_for_disappearance () { setup "down : une erreur de l'API n'est pas prise pour une disparition" - mutate '.linger = 100000 | .get_errors = 1 | .servers["srv-lab"] = {id: "srv-lab", name: "two-lab", project_id: "'"${PROJECT}"'", tags: ["two-lab"], status: "ready", install: {status: "completed"}, ips: []}' + mutate '.linger = 100000 | .get_errors = 1 | .servers["srv-lab"] = {id: "srv-lab", name: "labctl", project_id: "'"${PROJECT}"'", tags: ["labctl"], status: "ready", install: {status: "completed"}, ips: []}' LAB_DELETE_TIMEOUT=1 run_lab down && fail "down a réussi alors que le serveur existe encore" grep -q "TOUJOURS FACTURÉ" "${WORK}/out.log" || fail "pas d'alerte de facturation" teardown @@ -417,7 +417,7 @@ test_session_deletes_server_when_installation_times_out () { test_session_does_not_touch_existing_lab_server () { setup "session : ne supprime pas un serveur de lab lancé à côté" - mutate '.servers["srv-old"] = {id: "srv-old", name: "two-lab", project_id: "'"${PROJECT}"'", tags: ["two-lab"], status: "ready", install: {status: "completed"}, ips: []}' + mutate '.servers["srv-old"] = {id: "srv-old", name: "labctl", project_id: "'"${PROJECT}"'", tags: ["labctl"], status: "ready", install: {status: "completed"}, ips: []}' run_lab session true && fail "session a réussi" grep -q "^DELETE" "${WORK}/calls.log" && fail "suppression lancée" [[ $(remaining) == "foreign-1,foreign-2,srv-old" ]] || fail "restants : $(remaining)" @@ -432,8 +432,8 @@ test_missing_credentials_are_refused_before_any_call () { teardown } -LAB_SERVER='{id: "srv-lab", name: "two-lab", project_id: "'"${PROJECT}"'", tags: ["two-lab"], status: "ready", install: {status: "completed"}, ips: []}' -INSTALLING_LAB_SERVER='{id: "srv-lab", name: "two-lab", project_id: "'"${PROJECT}"'", tags: ["two-lab"], status: "ready", install: {status: "installing"}, ips: []}' +LAB_SERVER='{id: "srv-lab", name: "labctl", project_id: "'"${PROJECT}"'", tags: ["labctl"], status: "ready", install: {status: "completed"}, ips: []}' +INSTALLING_LAB_SERVER='{id: "srv-lab", name: "labctl", project_id: "'"${PROJECT}"'", tags: ["labctl"], status: "ready", install: {status: "installing"}, ips: []}' test_down_keeps_retrying_while_server_is_installing () { setup "down : réessaie au-delà du délai tant que le serveur s'installe" @@ -619,11 +619,11 @@ test_session_deletes_server_when_ssh_never_answers () { test_ssh_uses_dedicated_lab_key_only_when_present () { setup "ssh : clé dédiée du lab utilisée seule quand elle existe" mutate '.progress = [["ready","completed"]]' - mkdir -p "${WORK}/.config/two-lab/ssh" - : > "${WORK}/.config/two-lab/ssh/lab_ed25519" + mkdir -p "${WORK}/.config/labctl/ssh" + : > "${WORK}/.config/labctl/ssh/lab_ed25519" run_lab session uname || fail "code de sortie $?" grep -q " uname" "${WORK}/ssh.log" || fail "commande non lancée" - [[ $(grep -c -- "-i ${WORK}/.config/two-lab/ssh/lab_ed25519 -o IdentitiesOnly=yes -o IdentityAgent=none" "${WORK}/ssh.log") -eq $(wc -l < "${WORK}/ssh.log") ]] \ + [[ $(grep -c -- "-i ${WORK}/.config/labctl/ssh/lab_ed25519 -o IdentitiesOnly=yes -o IdentityAgent=none" "${WORK}/ssh.log") -eq $(wc -l < "${WORK}/ssh.log") ]] \ || fail "une connexion n'a pas utilisé la clé dédiée seule" teardown } @@ -638,10 +638,10 @@ test_ssh_falls_back_to_agent_without_lab_key () { } known_server () { - mkdir -p "${WORK}/.cache/two-lab" - echo 203.0.113.7 > "${WORK}/.cache/two-lab/ip" - echo debian > "${WORK}/.cache/two-lab/user" - : > "${WORK}/.cache/two-lab/known_hosts" + mkdir -p "${WORK}/.cache/labctl" + echo 203.0.113.7 > "${WORK}/.cache/labctl/ip" + echo debian > "${WORK}/.cache/labctl/user" + : > "${WORK}/.cache/labctl/known_hosts" } test_up_prepares_the_server_after_ssh () { @@ -691,7 +691,7 @@ test_prepare_without_known_server_is_refused () { } test_push_builds_for_linux_and_sends_binary_and_topology () { - setup "push : compile lab pour linux/amd64, envoie le binaire et le répertoire de la topologie" + setup "push : compile labctl pour linux/amd64, envoie le binaire et le répertoire de la topologie" known_server mkdir -p "${WORK}/conf/frr" printf 'name: evpn-2hv\n' > "${WORK}/conf/evpn-2hv.yml" @@ -700,9 +700,9 @@ test_push_builds_for_linux_and_sends_binary_and_topology () { run_lab push "${WORK}/conf/evpn-2hv.yml" || fail "code de sortie $?" local REPO LISTING REPO="$(cd "$(dirname "${SCRIPT}")/.." && pwd)" - [[ $(cat "${WORK}/go.log") == "${REPO}|build -o ${WORK}/.cache/two-lab/lab ./cmd/lab|CGO_ENABLED=0 GOOS=linux GOARCH=amd64" ]] \ + [[ $(cat "${WORK}/go.log") == "${REPO}|build -o ${WORK}/.cache/labctl/labctl ./cmd/labctl|CGO_ENABLED=0 GOOS=linux GOARCH=amd64" ]] \ || fail "compilation : $(cat "${WORK}/go.log")" - grep -q "debian@203.0.113.7 cat > 'lab.part' && chmod 755 'lab.part' && mv 'lab.part' 'lab'" "${WORK}/ssh.log" || fail "envoi de lab absent" + grep -q "debian@203.0.113.7 cat > 'labctl.part' && chmod 755 'labctl.part' && mv 'labctl.part' 'labctl'" "${WORK}/ssh.log" || fail "envoi de labctl absent" grep -q "debian@203.0.113.7 rm -rf topology.part && mkdir topology.part && tar -C topology.part --no-same-owner -xf - && rm -rf topology && mv topology.part topology" "${WORK}/ssh.log" \ || fail "envoi du répertoire absent" [[ $(cat "${WORK}/pushed.1") == "binaire-lab" ]] || fail "contenu de lab : $(cat "${WORK}/pushed.1")" @@ -711,7 +711,7 @@ test_push_builds_for_linux_and_sends_binary_and_topology () { grep -aq 'LIBARCHIVE.xattr' "${WORK}/pushed.2" && fail "attributs étendus macOS dans l'archive" mkdir "${WORK}/x" && tar -C "${WORK}/x" -xf "${WORK}/pushed.2" [[ $(cat "${WORK}/x/frr/rr1.conf") == "hostname rr1" ]] || fail "frr/rr1.conf altéré" - grep -q "ssh './lab up topology/evpn-2hv.yml'" "${WORK}/out.log" || fail "consigne finale absente" + grep -q "ssh './labctl up topology/evpn-2hv.yml'" "${WORK}/out.log" || fail "consigne finale absente" teardown } @@ -721,7 +721,7 @@ test_push_stops_when_the_build_fails () { printf 'name: x\n' > "${WORK}/x.yml" FAKE_GO_FAIL=1 run_lab push "${WORK}/x.yml" && fail "push a réussi" [[ -s "${WORK}/ssh.log" ]] && fail "ssh lancé" - grep -q "compilation de lab échouée" "${WORK}/out.log" || fail "message absent" + grep -q "compilation de labctl échouée" "${WORK}/out.log" || fail "message absent" teardown } @@ -730,7 +730,7 @@ test_push_fails_when_a_transfer_fails () { known_server printf 'name: x\n' > "${WORK}/x.yml" FAKE_PUSH_RC=1 run_lab push "${WORK}/x.yml" && fail "push a réussi" - grep -q "envoi de lab échoué" "${WORK}/out.log" || fail "message absent" + grep -q "envoi de labctl échoué" "${WORK}/out.log" || fail "message absent" teardown } @@ -753,8 +753,8 @@ test_push_refusals () { test_ssh_without_terminal_does_not_ask_for_one () { setup "ssh : pas de -t quand l'entrée n'est pas un terminal" known_server - run_lab ssh './lab status' < /dev/null || fail "code de sortie $?" - [[ $(cat "${WORK}/ssh.log") == *"debian@203.0.113.7 ./lab status" ]] || fail "commande : $(cat "${WORK}/ssh.log")" + run_lab ssh './labctl status' < /dev/null || fail "code de sortie $?" + [[ $(cat "${WORK}/ssh.log") == *"debian@203.0.113.7 ./labctl status" ]] || fail "commande : $(cat "${WORK}/ssh.log")" grep -q -- " -t " "${WORK}/ssh.log" && fail "-t demandé sans terminal" teardown } @@ -766,9 +766,9 @@ run_lab_without_env_credentials () { } write_credentials () { - mkdir -p "${WORK}/.config/two-lab" - printf '%s\n' "$@" > "${WORK}/.config/two-lab/scaleway.env" - chmod 600 "${WORK}/.config/two-lab/scaleway.env" + mkdir -p "${WORK}/.config/labctl" + printf '%s\n' "$@" > "${WORK}/.config/labctl/scaleway.env" + chmod 600 "${WORK}/.config/labctl/scaleway.env" } test_credentials_file_is_used_when_environment_is_empty () { @@ -782,9 +782,9 @@ test_credentials_file_is_used_when_environment_is_empty () { test_credentials_file_without_final_newline_is_read () { setup "identifiants : dernière ligne sans retour à la ligne lue quand même" - mkdir -p "${WORK}/.config/two-lab" - printf 'SCW_DEFAULT_PROJECT_ID=%s\nSCW_SECRET_KEY=%s' "${PROJECT}" "${SECRET}" > "${WORK}/.config/two-lab/scaleway.env" - chmod 600 "${WORK}/.config/two-lab/scaleway.env" + mkdir -p "${WORK}/.config/labctl" + printf 'SCW_DEFAULT_PROJECT_ID=%s\nSCW_SECRET_KEY=%s' "${PROJECT}" "${SECRET}" > "${WORK}/.config/labctl/scaleway.env" + chmod 600 "${WORK}/.config/labctl/scaleway.env" run_lab_without_env_credentials || fail "code de sortie $?" teardown } @@ -808,7 +808,7 @@ test_environment_value_kept_when_file_completes_the_rest () { test_credentials_file_readable_by_others_is_refused () { setup "identifiants : fichier lisible par d'autres refusé, sans aucun appel" write_credentials "SCW_SECRET_KEY=${SECRET}" "SCW_DEFAULT_PROJECT_ID=${PROJECT}" - chmod 644 "${WORK}/.config/two-lab/scaleway.env" + chmod 644 "${WORK}/.config/labctl/scaleway.env" run_lab_without_env_credentials && fail "plan a réussi" grep -q "chmod 600" "${WORK}/out.log" || fail "pas de consigne de droits" [[ -s "${WORK}/calls.log" ]] && fail "appel réseau avec un fichier exposé" @@ -892,9 +892,9 @@ test_no_zone_with_stock_is_refused_without_creation () { test_down_and_status_cover_every_candidate_zone () { setup "down et status : serveurs de lab de toutes les zones candidates" - mutate ".servers[\"lab-ams\"] = {id: \"lab-ams\", name: \"two-lab\", project_id: \"${PROJECT}\", tags: [\"two-lab\"], + mutate ".servers[\"lab-ams\"] = {id: \"lab-ams\", name: \"labctl\", project_id: \"${PROJECT}\", tags: [\"labctl\"], status: \"ready\", install: {status: \"completed\"}, ips: [], zone: \"nl-ams-2\", offer_name: \"EM-B420E-NVME\", created_at: \"now\"}" - mutate ".servers[\"lab-par\"] = {id: \"lab-par\", name: \"two-lab\", project_id: \"${PROJECT}\", tags: [\"two-lab\"], + mutate ".servers[\"lab-par\"] = {id: \"lab-par\", name: \"labctl\", project_id: \"${PROJECT}\", tags: [\"labctl\"], status: \"ready\", install: {status: \"completed\"}, ips: [], offer_name: \"EM-B212X-SSD\", created_at: \"now\"}" LAB_ZONES="fr-par-1 nl-ams-2" run_lab status grep -q '^nl-ams-2 lab-ams' "${WORK}/out.log" || fail "status : $(cat "${WORK}/out.log")" diff --git a/test/e2e/run.sh b/test/e2e/run.sh index 4b9e84d..3a34e7b 100755 --- a/test/e2e/run.sh +++ b/test/e2e/run.sh @@ -11,7 +11,7 @@ usage: ${0##*/} ... | all scénarios : $(cd "${SCENARIO_DIR}" && ls -- *.sh | sed 's/\.sh$//' | tr '\n' ' ') -Chaque scénario s'exécute depuis le Mac sur le lab en cours (lab-host.sh up, push, ./lab up). +Chaque scénario s'exécute depuis le Mac sur le lab en cours (lab-host.sh up, push, ./labctl up). Une ligne RÉUSSI ou ÉCHOUÉ par vérification ; code de sortie 1 si une vérification échoue ou si aucune n'a été faite. USAGE @@ -27,7 +27,7 @@ on () { done cat "${LAB_DIR}/lib/node.sh" cat - } | "${LAB_HOST}" ssh "./lab ssh ${node} 'sudo bash -s'" 2>&1 | tee -a "${SCENARIO_LOG}" + } | "${LAB_HOST}" ssh "./labctl ssh ${node} 'sudo bash -s'" 2>&1 | tee -a "${SCENARIO_LOG}" } run_scenario () { diff --git a/test/e2e/run_test.sh b/test/e2e/run_test.sh index 26393a9..9be98b1 100755 --- a/test/e2e/run_test.sh +++ b/test/e2e/run_test.sh @@ -46,7 +46,7 @@ test_on_sends_assignments_library_and_block_to_the_node () { setup "on : variables, bibliothèque et bloc envoyés au bon nœud" printf '%s\n' "on hv2 KEY='ssh-ed25519 AAAA x' NAME=vm <<'NODE'" 'echo "${NAME}"' 'NODE' > "${WORK}/scenarios/t1.sh" FAKE_OUT='RÉUSSI: un' run t1 || fail "code de sortie $?" - [[ $(cat "${WORK}/calls.log") == "ssh ./lab ssh hv2 'sudo bash -s'" ]] || fail "appel : $(cat "${WORK}/calls.log")" + [[ $(cat "${WORK}/calls.log") == "ssh ./labctl ssh hv2 'sudo bash -s'" ]] || fail "appel : $(cat "${WORK}/calls.log")" grep -q '^check () {' "${WORK}/payload.1" || fail "node.sh absent du bloc" [[ $(tail -n 1 "${WORK}/payload.1") == 'echo "${NAME}"' ]] || fail "bloc du scénario absent en fin d'envoi" [[ $(bash -c "$(grep '^export ' "${WORK}/payload.1"); printf '%s|%s' \"\${KEY}\" \"\${NAME}\"") == "ssh-ed25519 AAAA x|vm" ]] \