f-85: config: dhcp.backend vaut two par défaut, dnsmasq sur déclaration explicite, mise à jour depuis la 0.1.0 documentée #85

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-24 17:30:38 +02:00
commit 2c1279c5af
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
6 changed files with 27 additions and 21 deletions

View file

@ -68,7 +68,7 @@ metadata:
# The per-subnet control socket and state file live in /run/two/dhcp, which is # The per-subnet control socket and state file live in /run/two/dhcp, which is
# not configurable: the wrapper script hardcodes it too. # not configurable: the wrapper script hardcodes it too.
dhcp: dhcp:
backend: dnsmasq backend: two
# QEMU runtime paths # QEMU runtime paths
qemu: qemu:

View file

@ -80,9 +80,9 @@ démarrage, la racine étant en tmpfs. ``qemu-utils`` est demandé explicitement
**masqué** : il prendrait le port 53 en concurrence des instances ``dnsmasq@`` que l'agent lance **masqué** : il prendrait le port 53 en concurrence des instances ``dnsmasq@`` que l'agent lance
dans les netns. dans les netns.
``dnsmasq`` reste installé même avec ``dhcp.backend: two`` : le backend intégré ne le remplace que ``dnsmasq`` reste installé bien que ``dhcp.backend`` vaille ``two`` par défaut : le paquet sert
pour les subnets créés après la bascule, et le paquet est nécessaire tant qu'un hyperviseur peut aux hyperviseurs qui déclarent ``dhcp.backend: dnsmasq``, et tant qu'un hyperviseur peut revenir
revenir en arrière. Voir :doc:`/exploitation/configuration`. en arrière. Voir :doc:`/exploitation/configuration`.
**Noyau** — chargement de ``br_netfilter``, puis ``net.ipv4.ip_forward = 1`` et **Noyau** — chargement de ``br_netfilter``, puis ``net.ipv4.ip_forward = 1`` et
``net.bridge.bridge-nf-call-iptables = 1``. Cette dernière clé est **requise** par la DNAT vers ``net.bridge.bridge-nf-call-iptables = 1``. Cette dernière clé est **requise** par la DNAT vers

View file

@ -188,7 +188,7 @@ Backend DHCP
.. code-block:: yaml .. code-block:: yaml
dhcp: dhcp:
backend: dnsmasq # ou two backend: two # ou dnsmasq
Choisit qui sert le DHCP des subnets **créés par cet agent** : Choisit qui sert le DHCP des subnets **créés par cet agent** :
@ -206,8 +206,10 @@ Choisit qui sert le DHCP des subnets **créés par cet agent** :
- le binaire ``dhcp``, piloté par socket Unix - le binaire ``dhcp``, piloté par socket Unix
- ``dhcp@<netns>_<bridge>`` - ``dhcp@<netns>_<bridge>``
Le défaut est ``dnsmasq`` : un fichier de configuration de la 0.1.0, non modifié, se comporte Le défaut est ``two``. Un hyperviseur mis à jour depuis la 0.1.0 avec des subnets existants doit
exactement comme avant. Toute autre valeur que ``dnsmasq`` ou ``two`` fait échouer le démarrage. déclarer ``backend: dnsmasq`` avant la mise à jour, ou être vidé puis basculé (voir plus bas) : ses
subnets restent servis par dnsmasq. Toute autre valeur que ``dnsmasq`` ou ``two`` fait échouer le
démarrage.
Le répertoire d'exécution du backend ``two`` — ``/run/two/dhcp`` — **n'est pas configurable** : Le répertoire d'exécution du backend ``two`` — ``/run/two/dhcp`` — **n'est pas configurable** :
le script d'enrobage le code en dur, une clé que lui ignorerait serait un mensonge. le script d'enrobage le code en dur, une clé que lui ignorerait serait un mensonge.

View file

@ -31,27 +31,27 @@ func TestValidBackend_RejectsAnythingElse(t *testing.T) {
} }
} }
func TestLoadConfig_DefaultsToDnsmasq(t *testing.T) { func TestLoadConfig_DefaultsToTwo(t *testing.T) {
path := writeConfig(t, "database:\n path: /tmp/two\n") path := writeConfig(t, "database:\n path: /tmp/two\n")
cfg, err := LoadConfig(path) cfg, err := LoadConfig(path)
if err != nil { if err != nil {
t.Fatalf("LoadConfig: %v", err) t.Fatalf("LoadConfig: %v", err)
} }
if cfg.DHCP.Backend != BackendDnsmasq { if cfg.DHCP.Backend != "two" {
t.Errorf("backend = %q, want %q: a 0.1.0 config must keep behaving as before", cfg.DHCP.Backend, BackendDnsmasq) t.Errorf("backend = %q, want two: the built-in server is the default since 0.2.0", cfg.DHCP.Backend)
} }
} }
func TestLoadConfig_ReadsTheTwoBackend(t *testing.T) { func TestLoadConfig_ReadsTheDnsmasqBackend(t *testing.T) {
path := writeConfig(t, "dhcp:\n backend: two\n") path := writeConfig(t, "dhcp:\n backend: dnsmasq\n")
cfg, err := LoadConfig(path) cfg, err := LoadConfig(path)
if err != nil { if err != nil {
t.Fatalf("LoadConfig: %v", err) t.Fatalf("LoadConfig: %v", err)
} }
if cfg.DHCP.Backend != BackendTwo { if cfg.DHCP.Backend != "dnsmasq" {
t.Errorf("backend = %q, want two", cfg.DHCP.Backend) t.Errorf("backend = %q, want dnsmasq: an explicit dnsmasq must survive the new default", cfg.DHCP.Backend)
} }
} }
@ -76,7 +76,7 @@ func TestLoadConfig_MissingFileStillFallsBackToDefaults(t *testing.T) {
if err != nil { if err != nil {
t.Fatalf("an absent file remains valid, only an unreadable one is an error: %v", err) t.Fatalf("an absent file remains valid, only an unreadable one is an error: %v", err)
} }
if cfg.DHCP.Backend != BackendDnsmasq { if cfg.DHCP.Backend != "two" {
t.Errorf("backend = %q, want %q", cfg.DHCP.Backend, BackendDnsmasq) t.Errorf("backend = %q, want two", cfg.DHCP.Backend)
} }
} }

View file

@ -76,7 +76,7 @@ func LoadConfig(path string) (*Config, error) {
v.SetDefault("dispatcher.timeout_seconds", 300) v.SetDefault("dispatcher.timeout_seconds", 300)
v.SetDefault("dispatcher.poll_seconds", 2) v.SetDefault("dispatcher.poll_seconds", 2)
v.SetDefault("metadata.run_dir", "/run/two/metadata") v.SetDefault("metadata.run_dir", "/run/two/metadata")
v.SetDefault("dhcp.backend", BackendDnsmasq) v.SetDefault("dhcp.backend", BackendTwo)
v.SetDefault("qemu.ovmf_code_path", "/usr/share/OVMF/OVMF_CODE.fd") v.SetDefault("qemu.ovmf_code_path", "/usr/share/OVMF/OVMF_CODE.fd")
v.SetDefault("qemu.ovmf_vars_template", "/usr/share/OVMF/OVMF_VARS.fd") v.SetDefault("qemu.ovmf_vars_template", "/usr/share/OVMF/OVMF_VARS.fd")
v.SetDefault("qemu.uefi_vars_dir", "/run/two/vms/uefi") v.SetDefault("qemu.uefi_vars_dir", "/run/two/vms/uefi")

View file

@ -26,8 +26,7 @@ L3VNI, avec une configuration BGP pilotée par l'agent ; documentation du projet
**Coexistence avec dnsmasq** **Coexistence avec dnsmasq**
- Nouvelle clé `dhcp.backend`, `dnsmasq` ou `two`, qui choisit le serveur des subnets **créés par - Nouvelle clé `dhcp.backend`, `dnsmasq` ou `two`, qui choisit le serveur des subnets **créés par
cet agent**. Le défaut est `dnsmasq` : un fichier de configuration de la 0.1.0, non modifié, se cet agent**. Le défaut est `two` (#85) ; `dnsmasq` reste disponible jusqu'à son retrait (#49)
comporte exactement comme avant
- La bascule est une **opération manuelle** sur un hyperviseur vide — l'option ne migre rien, un - La bascule est une **opération manuelle** sur un hyperviseur vide — l'option ne migre rien, un
subnet déjà créé reste servi par le serveur qui l'a été. La procédure est documentée subnet déjà créé reste servi par le serveur qui l'a été. La procédure est documentée
- Toute valeur autre que `dnsmasq` ou `two` fait échouer le démarrage de l'agent - Toute valeur autre que `dnsmasq` ou `two` fait échouer le démarrage de l'agent
@ -199,8 +198,8 @@ curl -O https://git.g3e.fr/syonad/two/raw/branch/main/scripts/deploy.sh
bash ./deploy.sh -t 0.2.0 bash ./deploy.sh -t 0.2.0
``` ```
Sans `dhcp.backend` ni `bgp` dans `/etc/two/agent.yml`, le comportement est celui de la 0.1.0, à Sans `bgp` dans `/etc/two/agent.yml`, le comportement est celui de la 0.1.0, à six exceptions
cinq exceptions près ; les quatre premières touchent les appelants de l'API : près ; les quatre premières touchent les appelants de l'API :
- **`interface_ip` ne se fournit plus pour un subnet `vxlan`** : il est refusé (400), l'agent le - **`interface_ip` ne se fournit plus pour un subnet `vxlan`** : il est refusé (400), l'agent le
calcule. Le retirer des appels de création, et ne plus placer de VM sur les deux dernières calcule. Le retirer des appels de création, et ne plus placer de VM sur les deux dernières
@ -216,6 +215,11 @@ cinq exceptions près ; les quatre premières touchent les appelants de l'API :
l'underlay à 9000, ou poser `network.allow_mtu_underlay_below_9000: true` — sous 1550, il faut l'underlay à 9000, ou poser `network.allow_mtu_underlay_below_9000: true` — sous 1550, il faut
aussi abaisser `network.mtu_vm` avec `allow_mtu_vm_below_1500`. Les subnets existants gardent aussi abaisser `network.mtu_vm` avec `allow_mtu_vm_below_1500`. Les subnets existants gardent
leurs interfaces à 1500 jusqu'à leur recréation leurs interfaces à 1500 jusqu'à leur recréation
- **le DHCP passe par défaut au serveur intégré** (`dhcp.backend: two`) : sur un hyperviseur qui a
déjà des subnets, ajouter `dhcp.backend: dnsmasq` à `/etc/two/agent.yml` **avant**
`deploy.sh -t 0.2.0`. Sinon ses subnets restent servis par dnsmasq pendant que l'agent s'adresse
au serveur intégré : les VM existantes continuent, les nouvelles n'obtiennent pas d'adresse.
Un hyperviseur vide n'a rien à faire
Les subnets `vxlan` existants gardent leur adressage et le modèle précédent (gateway sur le Les subnets `vxlan` existants gardent leur adressage et le modèle précédent (gateway sur le
bridge) jusqu'à leur recréation. Les subnets `bridge` existants restent sans le confinement de bridge) jusqu'à leur recréation. Les subnets `bridge` existants restent sans le confinement de