Diagnostic#
Symptôme, cause probable, vérification. Les causes listées sont celles réellement rencontrées.
La ressource part en error juste après le 202#
Execute a échoué : la cause est dans le journal de l’agent, pas dans la réponse HTTP.
journalctl -u agent -n 100
Cas fréquents :
subnet en mode
public_ip— la mise en place host n’est pas implémentée, l’échec est attendu ;vxlan_iddéjà utilisé sur l’host ;bridge cible absent :
iface_typeinconnu retombé surdefault_interface, lui-même inexistant.
Avant toute recréation, émettre un DELETE : il n’y a pas de rollback, les objets système
partiellement créés subsistent.
La VM démarre mais n’a pas d’adresse#
Le DHCP est servi par une instance dédiée au subnet. Quelle unit selon dhcp.backend :
Backend ``dnsmasq``
systemctl status 'dnsmasq@<netns>_<bridge>'
tail -50 /var/log/dnsmasq-<netns>_<bridge>.log
cat /run/dnsmasq-<netns>_<bridge>.leases
cat /etc/dnsmasq.d/<netns>_<bridge>.conf
Backend ``two``
systemctl status 'dhcp@<netns>_<bridge>'
journalctl -u 'dhcp@<netns>_<bridge>' -n 50
# Ce que le serveur a réellement en mémoire
echo '{"verb":"get-state"}' \
| socat - UNIX-CONNECT:/run/two/dhcp/<netns>_<bridge>.sock | jq .
# Ce qu'il enverrait à une MAC donnée, sans effet de bord
echo '{"verb":"probe","mac":"00:22:33:00:00:0A"}' \
| socat - UNIX-CONNECT:/run/two/dhcp/<netns>_<bridge>.sock | jq '{served, lease}'
probe est le point de départ le plus rapide : il montre l’adresse, le masque, le routeur, les
DNS et les routes classless tels qu’ils partiraient. Une réponse "served": false signifie que
la MAC n’est pas réservée — l’ordre set-host n’a jamais atteint le serveur, ou la VM n’a pas
été créée par cet agent.
Le watchdog signale ces écarts de lui-même, à chaque tick, en comparant l’état servi à la base :
dhcp reservation missing on the server, stale dhcp reservation, dhcp reservation
diverges. Regarder ses notifications avant de sonder à la main. Seules les VM running sont
comparées : pendant une création ou une suppression, ou pour une VM en error, la réservation
peut être présente ou absente sans alerte.
Si le serveur ne voit passer aucune requête, le problème est en amont : tap absent, bridge non raccordé, VM dans le mauvais netns.
La VM ne joint pas sa gateway (subnet vxlan)#
La gateway d’un subnet vxlan est un macvlan gw-<subnet> à MAC anycast
(Modes réseau). Le watchdog contrôle sa présence, sa MAC, les adresses et l’entrée
FDB : ses notifications (interface gw-…, lacks the gateway address, no local fdb
entry…) disent déjà ce qui manque. À la main, dans le netns du VPC :
# macvlan actif, MAC 02:01:00:<VNI>, gateway en /32 ; adresse d'émission seule sur le bridge
ip -n <vpc> -br addr show gw-<subnet>
ip -n <vpc> -br addr show br-<subnet>
# entrée locale de la MAC anycast dans le bridge (« master br-<subnet> permanent »)
ip netns exec <vpc> bridge fdb show br br-<subnet> | grep 02:01:00
# route du subnet émise depuis la gateway
ip -n <vpc> -4 route show dev br-<subnet>
# confinement : source anycast rejetée sur le veth du subnet
ip netns exec <vpc> ebtables -t nat -L PREROUTING
ip netns exec <vpc> ebtables -L FORWARD
Dans le guest, ip neigh show <gateway> doit montrer la MAC 02:01:00:<VNI>. Une autre MAC —
celle d’un hôte, 02:03:… — signale un subnet de l’ancien modèle (sans relay_ip) ou une
gateway posée sur le bridge.
Depuis le netns d’un hôte, une VM d’un autre hôte ne répond qu’à l’adresse d’émission :
ip netns exec <vpc> ping -I <relay_ip> <ip>. Un ping sans -I part de la gateway et la
réponse revient à l’hôte de la VM — ce n’est pas une panne.
La VM a une adresse mais cloud-init n’applique rien#
Deux causes distinctes, à écarter dans cet ordre.
1. La VM porte déjà cet ``instance-id``. instance-id vaut le nom de la VM : sur un disque
déjà provisionné sous le même nom, cloud-init considère l’instance connue et ne rejoue pas le
user-data. Vérification dans le guest :
cloud-init query instance-id
ls /var/lib/cloud/instances/
2. Le serveur de metadata est injoignable. Depuis le guest — le serveur ne sert que
/meta-data, /user-data, /network-config et /vendor-data, tout autre chemin
renvoie 404 :
ip route
curl -s http://169.254.169.254/meta-data
La route 169.254.169.254/32 doit être présente, avec l”interface_ip du subnet comme
next-hop. Si elle est absente ou pointe ailleurs, la DNAT posée en PREROUTING dans le netns
n’est jamais traversée : la trame est commutée en L2 et le serveur reste injoignable. Voir
Modes réseau.
Depuis l’host, l’instance correspondante :
systemctl status 'metadata@<vm>'
ls -l /run/two/metadata/<vm>/
Le user-data est servi vide#
C’est le comportement attendu quand user_data est absent ou vide à la création : les deux cas
sont équivalents, et aucun template ne prend le relais pour user-data. Vérifier le contenu
réellement écrit :
cat /run/two/metadata/<vm>/user-data
Un base64 invalide, lui, aurait été rejeté en 400 à la création.
La VM ne démarre pas (UEFI)#
uefi: true exige les fichiers OVMF déclarés dans la configuration :
ls -l /usr/share/OVMF/OVMF_CODE.fd /usr/share/OVMF/OVMF_VARS.fd
ls -l /run/two/vms/uefi/
Sur Debian et Ubuntu, le paquet est ovmf.
Le DELETE renvoie 409#
La suppression n’est autorisée que depuis running ou error. Depuis creating ou
deleting, attendre l’état stable. Pour un VPC, tous les subnets doivent être supprimés
d’abord.
La base et le système ont divergé#
Le watchdog signale une ressource running absente du système. Il ne répare rien : la
correction est un DELETE explicite suivi d’une recréation. Après un redémarrage de l’agent,
les ressources restées transitoires sont basculées en error par la migration de démarrage —
elles n’ont pas forcément échoué, elles ont été interrompues.
L’agent ne redémarre pas après un arrêt brutal#
Badger rejoue son journal au démarrage : c’est normal et attendu, notamment si le budget d’arrêt
précédent a été dépassé et que la base n’a pas été fermée. Si le démarrage échoue vraiment, le
message se trouve dans journalctl -u agent.
Note
Les VM ne sont pas réattachées au redémarrage de l’agent : un processus QEMU survivant à l’agent n’est plus piloté par lui.