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:
parent
ef23f51125
commit
76b6657dbf
10 changed files with 224 additions and 8 deletions
|
|
@ -277,6 +277,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
|
||||
--------
|
||||
|
||||
|
|
|
|||
|
|
@ -145,6 +145,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)
|
||||
---------------------------
|
||||
|
||||
|
|
|
|||
|
|
@ -39,6 +39,16 @@ défaut** (``enabled: false``) ; l'activer explicitement :
|
|||
Il contrôle notamment l'existence des network namespaces, des liens réseau des subnets, des taps
|
||||
de VM et la réponse des units systemd associées.
|
||||
|
||||
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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
-----------------------
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue