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

@ -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
-----------------------