labctl: segments sur des bridges de l'hôte, routeurs et passerelle VRRP #2
All checks were successful
Tests / test (push) Successful in 3m46s
All checks were successful
Tests / test (push) Successful in 3m46s
Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
parent
e0de56a64f
commit
e9a0c19b72
24 changed files with 1766 additions and 578 deletions
35
README.md
35
README.md
|
|
@ -1,8 +1,8 @@
|
|||
# labctl
|
||||
|
||||
Monte un **lab réseau virtuel** à partir d'une topologie YAML : des VM QEMU/KVM reliées par des
|
||||
segments L2, des switchs qui font passerelle et NAT, FRR installé et configuré sur les nœuds qui
|
||||
le demandent, et une provision libre (scripts, fichiers, services à vérifier) pour installer ce
|
||||
segments L2 (des bridges de l'hôte), des routeurs qui font passerelle — en VRRP quand ils sont
|
||||
plusieurs — et NAT, FRR installé et configuré sur les nœuds qui le demandent, et une provision libre (scripts, fichiers, services à vérifier) pour installer ce
|
||||
que l'on veut tester. Le plan est **déterministe** : même fichier, mêmes adresses, MAC et ports.
|
||||
|
||||
`labctl` tourne sur tout hôte Linux avec KVM (virtualisation imbriquée si l'hôte est lui-même une
|
||||
|
|
@ -32,36 +32,43 @@ labctl status | down | ssh <nœud> [commande] [-run rép]
|
|||
```
|
||||
|
||||
Par défaut : `-run ~/lab-run`, `-cache ~/.cache/labctl`, `-timeout 20m`. `up` télécharge et vérifie
|
||||
les images (`SHA512SUMS`), crée des disques neufs, démarre les nœuds (switchs d'abord), attend la
|
||||
fin de cloud-init puis vérifie les services de chaque nœud. Un fichier invalide est refusé avec
|
||||
les images (`SHA512SUMS`), crée des disques neufs, les bridges des segments et les taps des nœuds,
|
||||
démarre les nœuds (routeurs d'abord), attend la fin de cloud-init puis vérifie les services de
|
||||
chaque nœud ; `down` arrête les nœuds et supprime bridges et taps. `up` et `down` tournent en
|
||||
root. Un fichier invalide est refusé avec
|
||||
toutes ses erreurs et un code de sortie 1.
|
||||
|
||||
## Topologie
|
||||
|
||||
Voir `examples/evpn-2hv/` : un switch, un route reflector et deux hôtes en EVPN.
|
||||
Voir `examples/evpn-2hv/` : deux routeurs en VRRP, un route reflector et deux hôtes en EVPN.
|
||||
|
||||
- `images` : `url` et `sums` (HTTPS).
|
||||
- `segments` : `switch`, `cidr` IPv4 (/8 à /30), `mtu` (9000 par défaut). Nom ≤ 12 caractères.
|
||||
- `nodes` : `role` (`switch`, `rr` ou `host`), `image`, `cpus`, `memory` (Mio), `segments`,
|
||||
`addresses` (adresse fixée par segment). Champs facultatifs :
|
||||
- `segments` : `cidr` IPv4 (/8 à /30), `mtu` (9000 par défaut), `routers` (facultatif, par ordre
|
||||
de priorité : aucun = L2 pur, un = passerelle sur son interface, plusieurs = passerelle en
|
||||
VRRP par FRR). Nom ≤ 12 caractères. Chaque segment est un bridge `lb-<segment>` de l'hôte.
|
||||
- `nodes` : `role` (`router`, `rr` ou `host`), `image`, `cpus`, `memory` (Mio), `segments`,
|
||||
`addresses` (adresse fixée par segment). Un routeur est un nœud comme les autres, attaché aux
|
||||
segments dont il est routeur. Champs facultatifs :
|
||||
- `secondary` — adresses supplémentaires hors du CIDR du segment ;
|
||||
- `loopback` — adresse sur une interface `dummy` `lo1` ;
|
||||
- `frr` — un `frr.conf` déposé tel quel ; FRR est installé au premier démarrage (`bgpd`, et
|
||||
`bfdd` sur `switch` et `rr`) ;
|
||||
`bfdd` sur `router` et `rr`, `vrrpd` sur les routeurs en VRRP) ;
|
||||
- `provision` / `post_provision` — scripts exécutés **avant** / **après** FRR ;
|
||||
- `files` — `{<nom>: <chemin>}`, fichiers **ou répertoires** gravés dans un ISO propre au nœud et
|
||||
recopiés dans `/etc/lab/files/<nom>` avant les scripts (aucune limite de taille cloud-init) ;
|
||||
- `services` — unités systemd que `up` vérifie actives.
|
||||
|
||||
Les chemins sont relatifs au fichier de topologie. Les scripts reçoivent `LAB_NODE`,
|
||||
`LAB_UPLINK` (interface du premier segment, qui porte la route par défaut) et `LAB_FILES`.
|
||||
Ordre au premier démarrage : script du switch ou de la loopback, `provision`, FRR,
|
||||
`LAB_UPLINK` (interface qui porte la route par défaut : premier segment qui a une passerelle,
|
||||
`mgmt0` pour un routeur)
|
||||
et `LAB_FILES`. Ordre au premier démarrage : service du routeur ou de la loopback, `provision`, FRR,
|
||||
`post_provision` — dans un seul script en `set -eu`, la première étape en échec met cloud-init en
|
||||
erreur.
|
||||
|
||||
Déduit de façon déterministe : passerelle d'un segment = première adresse (portée par le switch) ;
|
||||
adresses suivantes dans l'ordre de déclaration des nœuds ; MAC `02:4c:<nœud>:<nœud>:<segment>:<côté>` ;
|
||||
SSH d'administration sur `127.0.0.1:<2200 + rang>`. **Réordonner les nœuds change les adresses.**
|
||||
Déduit de façon déterministe : passerelle d'un segment = première adresse (s'il a un routeur) ;
|
||||
adresses suivantes dans l'ordre de déclaration des nœuds ; MAC `02:4c:<nœud>:<nœud>:<segment>:00` ;
|
||||
tap `lt<i>` par port ; SSH d'administration sur `127.0.0.1:<2200 + rang>`. **Réordonner les
|
||||
nœuds change les adresses.** Migration depuis 0.1 (rôle `switch`) : voir le guide.
|
||||
|
||||
## Hôte loué chez Scaleway : `scripts/lab-host.sh`
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue