f-86: doc: DNS et NTP des VM, two-hostsvc, notes 0.3.0 #86

Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>
This commit is contained in:
GnomeZworc 2026-10-25 21:11:20 +01:00
commit 46653c9f62
Signed by: nicolas.boufideline
GPG key ID: 4406BBBF8845D632
10 changed files with 224 additions and 8 deletions

View file

@ -282,6 +282,31 @@ La bascule est **manuelle** et suppose un hyperviseur vide :
Le retour arrière suit la même procédure. Il n'y a pas de bascule à chaud, dans un sens ni dans
l'autre.
Relais DNS et NTP
-----------------
.. code-block:: yaml
hostsvc:
dns_upstream: []
ntp_upstream: []
rate_limit_per_vpc: 100
Lue par ``two-hostsvc`` (voir :doc:`../concepts/dns-ntp`), au démarrage du service.
``dns_upstream``
résolveurs interrogés en premier, sous la forme ``ip`` ou ``ip:port`` (port 53 par défaut).
Ceux de ``/etc/resolv.conf`` de l'hôte viennent ensuite ; liste vide : l'hôte seul.
``ntp_upstream``
serveurs NTP relayés en premier, ``ip`` ou ``ip:port`` (port 123 par défaut). Sans serveur ou
sans réponse, l'horloge de l'hôte répond.
``rate_limit_per_vpc``
requêtes par seconde, DNS et NTP confondus, pour chaque VPC.
Un nom d'hôte, un port hors de 1–65535 ou une limite nulle ou négative font échouer le
démarrage de l'agent comme de ``two-hostsvc``, qui lisent le même fichier. Une modification prend
effet au redémarrage de ``two-hostsvc``.
Watchdog
--------

View file

@ -163,6 +163,41 @@ réellement écrit :
Un base64 invalide, lui, aurait été rejeté en 400 à la création.
La VM ne résout pas les noms ou n'a pas l'heure
-----------------------------------------------
La VM interroge sa gateway (``interface_ip``), que le DHCP annonce en DNS et en NTP ; la requête
est redirigée vers ``two-hostsvc`` dans le netns du VPC (voir :doc:`../concepts/dns-ntp`).
.. code-block:: bash
# Dans la VM : DNS et NTP annoncés par le bail (systemd-networkd)
sudo cat /run/systemd/netif/leases/$(cat /sys/class/net/ens3/ifindex) | grep -E '^(DNS|NTP)='
# Sur l'hyperviseur
systemctl status two-hostsvc
cat /run/two/hostsvc/hostsvc.state # le VPC doit y figurer
ip -n <vpc> -4 addr show dev hostsvc # 169.254.169.253/32
ip netns exec <vpc> iptables -t nat -S TWO-HOSTSVC # 2 RETURN puis 3 DNAT
ip netns exec <vpc> iptables -t nat -L TWO-HOSTSVC -v -n # compteurs des redirections
ip netns exec <vpc> ss -lntu | grep 169.254.169.253 # 53/udp, 53/tcp, 123/udp
journalctl -u two-hostsvc -n 50
Causes rencontrées :
* ``two-hostsvc`` arrêté : plus de DNS ni de NTP pour aucun VPC de l'hyperviseur, et un VPC créé
pendant ce temps part en ``error`` ;
* adresse ``169.254.169.253`` ou règle de la chaîne retirée à la main : la requête n'arrive plus
au relais ; le watchdog le signale ;
* VPC créé par une version antérieure à la 0.3.0 : ni ``dummy`` ni chaîne ni socket. Le recréer ;
* ``open`` refusé par ``two-hostsvc`` avec ``permission denied`` ou ``invalid argument`` sur
``/var/run/netns/<vpc>`` : l'unit n'a pas ``CAP_DAC_READ_SEARCH``, ou le netns, créé après le
démarrage du service, ne lui est pas visible parce que ``/`` n'est pas en propagation
``shared`` (``findmnt -no PROPAGATION /``). Rencontré en conteneur, pas sur un hyperviseur.
Sans serveur ``ntp_upstream`` qui réponde, l'heure vient de l'horloge de l'hyperviseur : si
celle-ci n'est pas synchronisée, la réponse porte l'indicateur d'alarme et la VM l'ignore.
La VM ne démarre pas (UEFI)
---------------------------

View file

@ -42,6 +42,16 @@ public (``interfaces.internet``) doit exister, être actif et porter un port VXL
(``vxlan-public``), sinon les VPC de l'hôte n'ont pas de segment public. Il ne vérifie pas le
numéro du VNI.
Dès qu'un VPC est ``running`` sur l'hyperviseur, il contrôle aussi le relais DNS et NTP (voir
:doc:`../concepts/dns-ntp`) :
* ``two-hostsvc`` injoignable sur sa socket de contrôle : une notification, aucun VPC de
l'hyperviseur n'a plus de DNS ni de NTP ;
* pour chaque VPC ``running`` : VPC absent de la liste servie par ``two-hostsvc``,
``169.254.169.253`` absente de la ``dummy`` ``hostsvc``, ou chaîne ``TWO-HOSTSVC`` absente ou
incomplète dans son netns. Un VPC créé par une version antérieure à la 0.3.0 n'a rien de tout
cela : il est signalé à chaque tick jusqu'à sa recréation.
Avec une section ``bgp`` dans la configuration, il contrôle aussi le plan de contrôle :
* **Sessions BGP** : une notification par route reflector dont la session n'est pas

View file

@ -1,7 +1,7 @@
Services systemd
================
Quatre units, installées dans ``/etc/systemd/system`` par ``deploy.sh`` ; les binaires et scripts
Cinq units, installées dans ``/etc/systemd/system`` par ``deploy.sh`` ; les binaires et scripts
qu'elles lancent sont sous ``/opt/two/bin``. Les deux units DHCP
s'excluent : celle qui tourne dépend de ``dhcp.backend`` (voir :doc:`configuration`).
@ -24,6 +24,10 @@ s'excluent : celle qui tourne dépend de ``dhcp.backend`` (voir :doc:`configurat
* - ``metadata@.service``
- ``<nom de la VM>``
- serveur de metadata cloud-init, un par VM
* - ``two-hostsvc.service``
- —
- relais DNS et NTP des VM, un par hyperviseur, démarré avant l'agent (voir
:doc:`../concepts/dns-ntp`)
Les instances sont créées et pilotées par l'agent au fil des créations de subnets et de VM : il
n'y a pas à les démarrer à la main en fonctionnement normal.
@ -34,6 +38,7 @@ n'y a pas à les démarrer à la main en fonctionnement normal.
systemctl status 'dnsmasq@vp-admin_br-000001' # backend dnsmasq
systemctl status 'dhcp@vp-admin_br-000001' # backend two
systemctl status 'metadata@i-web'
systemctl status two-hostsvc
dnsmasq
-------
@ -96,6 +101,27 @@ processus serait mort sans nettoyer (``SIGKILL``, plantage).
Diagnostic : voir :doc:`diagnostic`, qui montre comment interroger la socket.
Relais DNS et NTP
-----------------
``two-hostsvc.service`` lance ``/opt/two/bin/two-hostsvc``, un seul processus par hyperviseur,
qui sert DNS et NTP aux VM de tous les VPC (voir :doc:`../concepts/dns-ntp`). Il lit la section
``hostsvc`` de ``/etc/two/agent.yml`` (voir :doc:`configuration`).
.. list-table::
:widths: 40 60
* - Socket de contrôle
- ``/run/two/hostsvc/hostsvc.sock``
* - État
- ``/run/two/hostsvc/hostsvc.state`` (VPC servis)
* - Journal
- ``journalctl -u two-hostsvc``
L'unit démarre avant ``agent.service`` et se relance en cas d'échec. Son répertoire
``/run/two/hostsvc`` survit à un redémarrage du service : le processus y relit la liste des VPC
servis et rouvre leurs sockets. Un VPC ne peut pas être créé tant que le service ne répond pas.
QEMU n'est pas une unit
-----------------------