f-65: doc: deploy.sh -a, lab sur l'arbre courant, notes 0.3.0 #65

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-31 21:39:40 +01:00
commit 4a892138f9
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
3 changed files with 44 additions and 24 deletions

View file

@ -59,6 +59,12 @@ depuis la release, et les vérifie contre le manifeste ``SHA256SUMS``.
* - ``-R <secondes>``
- délai avant le redémarrage de secours pendant la migration réseau
- ``120``
* - ``-a <répertoire>``
- installer hors ligne, depuis un répertoire local au format d'une release (mêmes noms
d'assets, ``SHA256SUMS`` compris) : ni appel à l'API ni téléchargement des assets. Le
tag ``-t`` ne sert alors qu'à nommer ``/opt/two/<tag>/``. Les scripts de ``-i`` sont
lus dans ``/opt/two/scripts/`` s'ils y sont
- désactivé ; tag ``local``
* - ``-d``
- dry-run : affiche les commandes sans les exécuter
- désactivé

View file

@ -99,20 +99,25 @@ clé du dépôt embarquée dans l'outil) : voir la section FRR du guide de ``lab
**Hyperviseurs.** Ce sont des nœuds ``host`` dont la provision installe two comme en
production. ``test/e2e/topologies/provision/hypervisor.sh`` dépose ``agent.yml`` (fichier
``agent.yml`` du nœud) dans ``/etc/two/agent.yml``, télécharge ``deploy.sh`` et
``bootstrap_kvm.sh`` **au tag de la release testée** dans ``/opt/two/scripts/``, où ``deploy.sh``
cherche d'abord ``bootstrap_kvm.sh``, puis lance :
``agent.yml`` du nœud) dans ``/etc/two/agent.yml``, installe ``deploy.sh`` et ``bootstrap_kvm.sh``
dans ``/opt/two/scripts/``, où ``deploy.sh`` cherche d'abord ``bootstrap_kvm.sh``, puis lance
``deploy.sh -i``. Ce qu'il déploie dépend de ce que ``test/e2e/build.sh`` a préparé dans
``test/e2e/topologies/`` (transmis par ``files: {bin: bin, scripts: scripts}``) ; sans rien de
préparé, la provision échoue (#65) :
.. code-block:: text
* **arbre courant** (``build.sh``, par défaut) : ``deploy.sh`` et ``bootstrap_kvm.sh`` de l'arbre,
puis ``deploy.sh --noup_script -i -u "$LAB_UPLINK" -N 1 -a <files>/bin -t <commit>``. Tout vient
de l'arbre — bootstrap (paquets, noyau, réseau, segment public), binaires, ``run-*.sh``, units —
sans télécharger d'asset ;
* **release** (``build.sh --release <tag>``) : ``deploy.sh`` et ``bootstrap_kvm.sh`` téléchargés au
tag, puis ``deploy.sh --noup_script -i -u "$LAB_UPLINK" -t <tag>`` : la release telle que
publiée, pour qualifier ses fichiers avant de la livrer.
deploy.sh --noup_script -i -u "$LAB_UPLINK" -t <release>
La release est fixée dans le script (``RELEASE=``) : sans elle, ``deploy.sh`` prendrait la dernière,
et le lab ne serait plus reproductible. ``--noup_script`` empêche l'auto-mise à jour de remplacer le
script par celui de ``main``. L'uplink ``-u`` est l'interface qui porte la route par défaut, parce
que ``deploy.sh`` y lit l'adresse et la passerelle qu'il déplace sur ``br-000000``. ``deploy.sh``
télécharge la release sur ``git.g3e.fr`` sans réessayer : le script attend d'abord que le serveur
réponde, à travers le switch. Les deux fichiers ``agent/`` donnent à l'agent la section ``bgp``
``--noup_script`` empêche l'auto-mise à jour de remplacer le script par celui de ``main``.
L'uplink ``-u`` est l'interface qui porte la route par défaut, parce que ``deploy.sh`` y lit
l'adresse et la passerelle qu'il déplace sur ``br-000000``. ``deploy.sh`` télécharge
``shflags`` (et, en mode release, la release) sur ``git.g3e.fr`` sans réessayer : le script
attend d'abord que le serveur réponde, à travers le switch. Les deux fichiers ``agent/`` donnent à l'agent la section ``bgp``
(AS 64600, route reflectors ``10.255.255.1`` et ``10.255.255.2``) et un watchdog toutes les 10 s ;
``agent/two.yml`` met en plus hv1 sur le serveur DHCP intégré (``dhcp.backend: two``),
``agent/dnsmasq.yml`` met explicitement les autres sur dnsmasq (``dhcp.backend: dnsmasq``).
@ -144,21 +149,20 @@ registre RFC 6890) et jamais routée sur Internet. Les bordures sont déclarées
hyperviseurs : les adresses et les taps de l'underlay ne changent pas, ceux du segment ``lan``
sont renumérotés.
**Tester l'arbre courant plutôt que la release.** ``test/e2e/build.sh`` compile ``agent``,
``dhcp``, ``metadata`` et ``two-hostsvc`` pour linux/amd64 dans ``test/e2e/topologies/bin/``
(ignoré par git), et y copie l'unit ``two-hostsvc.service``, absente de la release 0.2.0 ; les
hyperviseurs reçoivent le répertoire par ``files: {bin: bin}``. Après ``deploy.sh``,
``hypervisor.sh`` installe chaque binaire présent dans ``/opt/two/local/bin/`` et y fait pointer
``/opt/two/bin/<nom>``, puis installe, active et redémarre chaque unit ``*.service`` présente ; le
reste (units, scripts) vient de la release. ``build.sh --clean`` vide le répertoire : le lab
suivant teste la release seule.
**Préparer l'arbre courant ou une release.** ``test/e2e/build.sh`` prépare dans
``test/e2e/topologies/bin/`` (ignoré par git) les assets de l'arbre au format d'une release :
``agent``, ``dhcp``, ``metadata`` et ``two-hostsvc`` compilés pour linux/amd64 (version = commit
court, ``-dirty`` si l'arbre a des modifications), ``run-dnsmasq-in-netns.sh``,
``run-dhcp-in-netns.sh``, les cinq units, ``SHA256SUMS`` et ``VERSION`` ; il copie ``deploy.sh`` et
``bootstrap_kvm.sh`` dans ``test/e2e/topologies/scripts/``. ``build.sh --release <tag>`` ne laisse
qu'un fichier ``RELEASE`` ; ``build.sh --clean`` vide les deux répertoires.
.. code-block:: text
test/e2e/build.sh # binaires de l'arbre courant
test/e2e/build.sh # arbre courant, en entier
test/e2e/labctl.sh push test/e2e/topologies/evpn-3hv.yml
test/e2e/labctl.sh ssh './labctl up topology/evpn-3hv.yml'
test/e2e/build.sh --clean # retour à la release seule
test/e2e/build.sh --release 0.3.0 # qualifier une release publiée
FRR est installé **après** la provision : il démarre sur le réseau final. Démarré
avant la migration, zebra peut perdre la route par défaut quand elle passe de l'uplink à

View file

@ -113,6 +113,16 @@
- Une IP flottante est refusée (409) sur une interface d'un subnet `public_ip`. Le watchdog
contrôle les subnets `public_ip` comme les subnets `bridge`
**Installation hors ligne : `deploy.sh -a` (#65)**
- Nouvelle option `-a <répertoire>` (`--assets_dir`) : `deploy.sh` installe depuis un répertoire
local au format d'une release (mêmes noms d'assets, `SHA256SUMS` vérifié comme celui d'une
release), sans appel à l'API ni téléchargement des assets. `-t` nomme alors `/opt/two/<tag>/`
(`local` par défaut)
- Le lab déploie désormais l'arbre courant en entier par cette option (bootstrap, binaires,
scripts, units), sans télécharger de release ; `test/e2e/build.sh --release <tag>` garde la
qualification d'une release publiée
**Connaissance de l'hôte (#39)**
- `GET /register` : hostname, CPU (fabricant, modèle, sockets, cœurs, threads), RAM totale, OS