Installation d’un hyperviseur#
Cette page installe l’agent sur un hyperviseur. Le réseau du cluster — routage entre nœuds, plan de contrôle — est traité à part : voir Déploiement d’un cluster.
Prérequis#
Un host Linux avec KVM, sur lequel vous avez root. Les opérations réseau (network
namespaces, netlink, VXLAN, nftables) et QEMU ne fonctionnent que sous Linux.
Déploiement#
curl -O https://git.g3e.fr/syonad/two/raw/branch/main/scripts/deploy.sh
bash ./deploy.sh -t 0.2.0 -i
deploy.sh se met à jour lui-même depuis la branche avant toute action — s’il diffère, il se
réécrit et demande d’être relancé. Il télécharge ensuite binaires, units systemd et scripts
depuis la release, et les vérifie contre le manifeste SHA256SUMS.
Option |
Effet |
Défaut |
|---|---|---|
|
déployer une release donnée |
dernière publiée, préversions comprises |
|
branche d’où viennent l’auto-mise à jour du script et les scripts de |
|
|
profil d’host ; seul |
|
|
préparer l’host : paquets, noyau, réseau |
désactivé |
|
interface physique d’uplink |
|
|
bridge principal, auquel l’uplink est rattaché |
|
|
bridge public, sans adresse : il porte |
|
|
VNI du segment public, partagé avec les bordures ( |
|
|
délai avant le redémarrage de secours pendant la migration réseau |
|
|
dry-run : affiche les commandes sans les exécuter |
désactivé |
Les options booléennes actives par défaut se désactivent par leur forme longue négative :
--nopackages, --nonetwork, --noverify, --noup_script.
Avertissement
--noverify désactive la seule vérification d’intégrité des artefacts téléchargés. Ne
l’utiliser que pour diagnostiquer un manifeste cassé, jamais en déploiement courant.
Ce que fait -i#
Paquets — qemu-system-x86, qemu-utils, ovmf, dnsmasq, nftables,
nfs-common, jq, curl, sans les paquets recommandés : ceux de
qemu-system-x86 (interface graphique, gtk, gstreamer, pilotes de stockage réseau) ne servent
pas à un hyperviseur sans écran, et l’installation passe d’environ 270 à 65 Mo — rejouée à chaque
démarrage, la racine étant en tmpfs. qemu-utils est demandé explicitement : qemu-img sert
à la construction de l’image (Construction de l’image qcow2). Le service dnsmasq du système est ensuite désactivé et
masqué : il prendrait le port 53 en concurrence des instances dnsmasq@ que l’agent lance
dans les netns.
dnsmasq reste installé bien que dhcp.backend vaille two par défaut : le paquet sert
aux hyperviseurs qui déclarent dhcp.backend: dnsmasq, et tant qu’un hyperviseur peut revenir
en arrière. Voir Configuration.
Noyau — net.ipv4.ip_forward = 1. br_netfilter n’est pas chargé : le filtrage des
ponts est en nftables (famille bridge) et les redirections vers le serveur de metadata et
vers two-hostsvc sont posées dans le netns de chaque VPC, où l’agent coupe déjà
bridge-nf-call-*. Chargé, le module ferait passer tout le trafic bridgé des VM par netfilter
(bridge-nf-call-iptables vaut 1 par défaut).
Réseau — création du bridge public, puis rattachement de l’uplink au bridge principal, l’adresse et la route par défaut étant déplacées de l’interface physique vers le bridge.
Segment public — vxlan-public est créé avec le VNI de -N, l’adresse IPv4 du bridge
principal pour VTEP (comme les VXLAN de l’agent), le port 4789, sans apprentissage (les MAC
distantes viennent d’EVPN) et un MTU de 1500, puis rattaché au bridge public. FRR l’annonce de
lui-même (advertise-all-vni). Relancer -i ne change rien ; le VXLAN est recréé si son VNI
ou son VTEP a changé.
Chaque VPC vp-<id> raccorde au bridge public un veth vp-<id>-e côté host, dont l’autre
extrémité vp-<id>-i rejoint un br-public créé dans le netns du VPC. L’agent lit le nom
du bridge public dans interfaces.internet (br-public par défaut) : avec un autre nom
passé à -P sans le reporter dans cette clé, toute création de VPC échoue.
Danger
La migration réseau coupe le réseau de l’host si elle échoue à mi-parcours, sans console
de secours. Deux garde-fous sont en place : un redémarrage de secours armé avant l’opération
(-R, 120 s par défaut) qui ramène la configuration d’origine puisque rien n’est écrit sur
disque, et l’exécution de la séquence sous systemd plutôt que dans la session SSH, pour
qu’une coupure de SSH ne l’interrompe pas.
Le désarmement n’a lieu qu’après un ping réussi vers la passerelle. Prévoir un accès
physique ou console avant de lancer un -i à distance sur un host de production.
Host sans état#
L’hyperviseur est stateless : sa racine est en tmpfs, rien de ce que pose -i ne survit à
un redémarrage. deploy.sh --bootstrap est donc rejoué à chaque démarrage — c’est le
mécanisme normal, pas une réparation.
Binaires installés#
Binaire |
Rôle |
Drapeau de config |
|---|---|---|
|
processus principal : API, dispatcher, exécution, watchdog |
|
|
serveur de metadata cloud-init, une instance par VM dans le netns du VPC |
|
|
inspection de la base clé-valeur en ligne de commande ; ni publié ni déployé par
|
|
|
serveur DHCP intégré, une instance par subnet dans le netns du VPC ; démarré uniquement
avec |
|
Les quatre lisent le même fichier, /etc/two/agent.yml — voir
Configuration. dhcp reçoit en plus son bridge et ses deux chemins de
fichiers en paramètres, posés par son script d’enrobage.
Mise à jour#
deploy.sh relève les instances dnsmasq@, dhcp@ et metadata@ actives avant
d’arrêter les services, et les redémarre ensuite : c’est la seule façon de savoir lesquelles
relancer. Arrêter les services à la main avant de lancer le script fait perdre cette liste.
Vérifier l’installation#
systemctl status two-hostsvc agent
curl -s http://127.0.0.1:8080/vpcs
Une liste JSON — vide au premier démarrage — signifie que l’API répond. two-hostsvc, le relais
DNS et NTP des VM, doit être actif : sans lui, la création d’un VPC échoue (voir
DNS et NTP des VM). Passez à Premier VPC, premier subnet, première VM.
Important
L’API de l’agent n’a aucune authentification. Avant d’ouvrir le port au-delà de la boucle locale, lisez l’avertissement de Configuration : quiconque atteint ce port pilote la totalité de l’hyperviseur.