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:
parent
215f16ce62
commit
4a892138f9
3 changed files with 44 additions and 24 deletions
|
|
@ -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é
|
||||
|
|
|
|||
|
|
@ -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 à
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue