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:
parent
c628e7072a
commit
2c1279c5af
6 changed files with 27 additions and 21 deletions
|
|
@ -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:
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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.
|
||||||
|
|
|
||||||
|
|
@ -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)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -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")
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue