erplibre/long_test/descente.py
Mathieu Benoit cfbdd9406e [REF] format : passer l'outillage et les tests sous ruff
Le formateur de ce dépôt est ruff depuis qu'il remplace black, qui ne connaît
aucune cible au-delà de py313 ; ce passage applique sa norme à l'arbre entier,
d'un coup, pour qu'aucun commit de fond n'ait à porter du style. L'écart tient
presque entièrement aux chaînes coupées à la main que ruff recolle quand elles
tiennent sur une ligne, et aux « with » multiples qu'il regroupe : aucune
valeur ne change, et les clés de traduction non plus.
Vérifié : la suite unitaire reste verte après le passage, et le contrôle de
syntaxe ne signale rien.

--- EN ---

This repository's formatter is ruff since it replaced black, which knows no
target beyond py313; this pass applies its standard to the whole tree at once,
so that no substantive commit has to carry style. The difference is almost
entirely the hand-split strings ruff joins back when they fit on one line, and
the multiple "with" it merges: no value changes, nor do the translation keys.
Checked: the unit suite stays green after the pass, and the syntax check
reports nothing.

Assisted-by: Claude Opus 5
2026-09-24 14:40:38 -04:00

1351 lines
55 KiB
Python

#!/usr/bin/env python3
# © 2026 TechnoLibre (http://www.technolibre.ca)
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)
"""Le moteur commun aux tests longs : descendre étage par étage.
Ce module ne sait rien de Proxmox ni de libvirt. Il sait ce qui est vrai de
TOUTE descente imbriquée, et qui a coûté cher à apprendre :
* un étage doit être inscrit au rapport à l'instant où sa machine existe, pas
au retour de la fonction qui la crée ;
* le délai de chaque étape croît avec la profondeur, parce que c'est
exactement ce qu'on mesure ;
* attendre un enfant dont le PARENT ne répond plus est une attente perdue ;
* on ne détruit jamais d'après un nom, et jamais ce qu'on n'a pas créé.
Chaque pile fournit ses VERBES en héritant de `Descente` : comment créer un
enfant, comment installer, ce que « le noyau convient » veut dire, comment
remettre les services debout, comment contrôler qu'un étage peut héberger le
suivant. Le reste est ici, écrit une fois.
"""
import argparse
import json
import os
import re
import shlex
import subprocess
import sys
import time
RACINE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.insert(0, RACINE)
from script.proxmox import nesting # noqa: E402
from script.proxmox import proxmox_deploy as pve # noqa: E402
# Les scripts qui lancent une descente. Le verrou les cherche TOUS : deux
# descentes de piles différentes se disputeraient la RAM, le disque et
# ~/.ssh/config aussi sûrement que deux de la même.
SCRIPTS = (
"deep_proxmox.py",
"deep_qemu.py",
"install_nixos.py",
"qemu_cache.py",
)
# L'autorité du cache de téléchargement, telle que le service l'écrit sur
# l'hôte. Une seule définition pour tout long_test/ : une seconde dériverait
# en silence, et un test qui pose la mauvaise autorité échoue comme s'il n'en
# posait aucune.
CACHE_CA = "/var/lib/erplibre_go_qemu_cache/ca.crt"
def drapeaux_cache():
"""Les drapeaux de cache à passer à la CLI QEMU pour une VM locale.
Le détournement est TRANSPARENT et vaut pour tout le pont libvirt : une
VM créée ici est interceptée qu'elle le demande ou non. Ne rien passer ne
la laisse donc pas en direct — elle reçoit un certificat qu'elle ne
reconnaît pas, et chaque téléchargement HTTPS échoue sur « self-signed
certificate in certificate chain » : l'image, puis le gestionnaire de
paquets, puis tout le reste de l'étage.
Deux issues, et elles se valent pour le test : approuver l'autorité quand
l'hôte en porte une, ou demander une exception par adresse MAC sinon. Sur
un hôte sans cache, l'exception ne fait rien et le dit — la CLI n'exige
pas d'installer un cache pour pouvoir s'en passer.
"""
if os.path.isfile(CACHE_CA):
return ["--cache-ca", CACHE_CA]
return ["--cache-bypass"]
# Une étape bloquée ne doit pas bloquer le test : chaque appel est borné, et le
# journal dit lequel a expiré. Généreux, parce que chaque étage est plus lent
# que le précédent — c'est précisément ce qu'on mesure.
DELAIS = {
"creation": 1200,
"ssh": 2400,
"install": 7200,
"reboot": 2400,
"reparation": 600,
"controle": 180,
}
def dire(msg, journal=None):
ligne = f"[{time.strftime('%H:%M:%S')}] {msg}"
print(ligne, flush=True)
if journal:
with open(journal, "a", encoding="utf-8") as fh:
fh.write(ligne + "\n")
def capacite_hote():
"""(cœurs, RAM disponible en Mo, disque libre en Go) de la machine réelle.
« available » et non « free » : c'est ce que le noyau promet de rendre sans
mettre la machine à genoux.
"""
coeurs = os.cpu_count() or 2
ram = 0
try:
with open("/proc/meminfo", encoding="utf-8") as fh:
for ligne in fh:
if ligne.startswith("MemAvailable:"):
ram = int(ligne.split()[1]) // 1024
break
except OSError:
pass
disque = 0
try:
st = os.statvfs("/var/lib/libvirt/images")
disque = (st.f_bavail * st.f_frsize) // (1024**3)
except OSError:
pass
return coeurs, ram, disque
CAPACITE_CMD = (
"nproc | sed s/^/COEURS=/; "
"grep MemAvailable /proc/meminfo | sed s/^/MEM=/; "
"df --output=avail -BG /var/lib/libvirt/images 2>/dev/null"
" | tail -1 | sed s/^/DISQUE=/"
)
def parse_capacite(texte):
"""(cœurs, RAM en Mo, disque en Go) lus chez l'hôte, ou (0, 0, 0).
Zéro quand la ligne manque, jamais une valeur inventée : un plan
dimensionné sur une capacité supposée annoncerait des étages qui ne
tiennent pas.
"""
propre = pve.strip_ssh_noise(texte or "")
def lire(motif, diviseur=1):
trouve = re.search(motif, propre, re.M)
return int(trouve.group(1)) // diviseur if trouve else 0
return (
lire(r"^COEURS=\s*(\d+)"),
# « MEM=MemAvailable: 7056288 kB » : le sed colle un « = », pas un
# deux-points. L'expression attendait le second et rendait zéro — un
# plan dimensionné sur zéro mébioctet n'annonce aucun étage.
lire(r"^MEM=MemAvailable:\s*(\d+)", 1024),
lire(r"^DISQUE=\s*(\d+)"),
)
def capacite_distante(hote):
"""Ce dont dispose la RACINE quand la descente en emprunte une.
`capacite_hote()` lit la machine LOCALE. Partir d'un hôte distant sans
lire le sien dimensionnerait le plan d'après une machine qui n'héberge
rien — on annoncerait dix étages sur un serveur qui n'en porte pas deux.
"""
code, out = pve.run(dict(hote, sudo=""), CAPACITE_CMD, 120)
if code:
return 0, 0, 0
return parse_capacite(out)
def module_qemu():
"""deploy_qemu.py chargé comme module : il porte le catalogue d'images."""
import importlib.util
chemin = os.path.join(RACINE, "script/qemu/deploy_qemu.py")
spec = importlib.util.spec_from_file_location("deploy_qemu", chemin)
mod = importlib.util.module_from_spec(spec)
spec.loader.exec_module(mod)
return mod
def cle_publique():
for nom in ("id_ed25519.pub", "id_rsa.pub"):
chemin = os.path.expanduser(f"~/.ssh/{nom}")
if os.path.exists(chemin):
return chemin
return ""
def nom_etage(niveau, base):
return f"{base}-{niveau}"
def alias_etage(niveau, parent_alias, base):
"""L'alias ssh de l'étage : celui du parent, puis le sien.
Chaîné, parce qu'un nom seul ne dit pas PAR OÙ passer : deux descentes
peuvent avoir un « -2 », et OpenSSH doit savoir de quel parent il rebondit.
"""
court = re.sub(r"[^A-Za-z0-9._-]", "-", parent_alias)
return f"{court}+{nom_etage(niveau, base)}"
class Descente:
"""Un étage après l'autre, et ce qu'on en sait.
Classe de BASE : elle mène la descente, tient le rapport et refuse de
détruire ce qu'elle n'a pas créé. Ce qu'elle ne sait pas faire, elle le
demande à la pile qui en hérite — les six crochets plus bas.
"""
# Une descente sans racine part d'une VM qu'elle crée elle-même : c'est
# le cas ordinaire, et ces défauts le disent au niveau de la CLASSE plutôt
# que du constructeur, pour qu'une instance montée à la main les ait aussi.
racine = None
profondeur_racine = 0
# Ce que chaque pile déclare.
OUTIL = "" # « deep_proxmox » : écrit au rapport, filtre --detruire
NOM_BASE = "" # « deep-pve » : préfixe des noms de machines
DISTRO = "" # la clé du catalogue d'images de deploy_qemu
# ------------------------------------------------------------------ #
# Les crochets. Chacun rend True quand l'étape a été CONSTATÉE.
# ------------------------------------------------------------------ #
def preparer_parent(self, parent):
"""Ce qu'il faut du parent pour créer chez lui, ou None."""
raise NotImplementedError
def creer_enfant(self, parent, niveau, res, prepare, noter=None):
"""Rend (identité, adresse), ou (None, None).
`noter` reçoit l'identité AVANT la première commande qui peut créer
la machine — sinon une création qui échoue à mi-chemin laisse une VM
que le rapport ne nomme nulle part.
"""
raise NotImplementedError
def installer(self, hote):
"""Pose la pile sur l'étage."""
raise NotImplementedError
def noyau_convient(self, noyau):
"""`uname -r` annonce-t-il le noyau qu'on attend ?"""
raise NotImplementedError
def remettre_debout(self, hote):
"""Les services de la pile répondent-ils, une fois redémarrés ?"""
raise NotImplementedError
def rallumer_a_froid(self, parent, nom):
"""Éteindre puis rallumer la machine DEPUIS SON PARENT. Rend True si
la pile sait le faire.
Un redémarrage demandé à l'invité — « systemctl reboot » — peut le
laisser bloqué dans son micrologiciel : constaté une fois au troisième
étage, pointeur d'instruction immobile pendant 46 minutes, pas un
octet lu. Un démarrage à FROID, lui, repart d'un processus neuf, et
les trois essais faits ensuite ont tous abouti.
La cause du gel n'est pas établie ; le remède ne l'attend pas. Une
descente ne doit pas passer six heures à guetter une machine qui ne
reviendra jamais, quand son parent peut la rallumer.
"""
return False
def controler(self, hote):
"""Cet étage peut-il HÉBERGER le suivant ?
Sixième étape, et elle n'existait pas : le contrôle du stockage était
celui du DÉBUT de l'étage suivant, si bien qu'un étage marqué
« terminé » pouvait être incapable d'héberger quoi que ce soit — et le
compteur d'étages atteints mentait d'autant.
"""
raise NotImplementedError
def nom_etage(self, niveau):
return nom_etage(niveau, self.NOM_BASE)
def alias_etage(self, niveau, parent_alias):
return alias_etage(niveau, parent_alias, self.NOM_BASE)
def __init__(
self,
plan,
journal,
dry_run=False,
chemin_json=None,
racine=None,
profondeur_racine=0,
):
# `racine` : un hôte qui EXISTE DÉJÀ, chez qui la descente s'installe
# au lieu de créer sa propre machine de tête. Il n'est pas un étage —
# il n'est pas compté, pas détruit, et son entrée ~/.ssh/config est
# celle de l'utilisateur.
self.racine = racine
# Sa profondeur d'imbrication à LUI. Sans elle, le premier enfant
# d'une racine déjà au troisième étage héritait des délais du premier :
# quatre fois trop courts, exactement le défaut que `delai` raconte
# avoir corrigé.
self.profondeur_racine = profondeur_racine
self.plan = plan
self.journal = journal
self.chemin_json = chemin_json
self.dry_run = dry_run
self.etages = []
self.interrompu = False
self.niveau_courant = 1
def dire(self, msg):
dire(msg, self.journal)
def delai(self, etape):
"""Le délai de cette étape, à l'étage courant.
Constant, il contredisait la raison d'être du script : au quatrième
étage un invité tournait 36 fois moins vite. Une installation de dix
minutes au premier étage en demande des heures au quatrième, et le
plafond fixe la déclarait échouée — en concluant à un mur
d'imbrication là où il n'y avait qu'un délai trop court.
Le facteur est CARRÉ et borné : chaque étage ajoute une couche
d'hyperviseur à traverser, mais un facteur illimité rendrait un
échec réel indiscernable d'une attente sans fin.
"""
# La profondeur ABSOLUE : celle de la racine plus celle de l'étage.
# Un enfant de niveau 1 posé dans une racine déjà au troisième étage
# est en réalité au quatrième, et ses délais doivent le savoir.
profondeur = self.profondeur_racine + max(1, self.niveau_courant)
facteur = min(profondeur, 5) ** 2
return DELAIS[etape] * facteur
# ---------------------------------------------------------------- #
# Parler aux machines
# ---------------------------------------------------------------- #
def executer(self, hote, remote, delai, etiquette, montrer=False):
if self.dry_run:
argv = pve.ssh_argv(
hote, pve.wrap_privilege(remote, hote.get("sudo") or "")
)
print(" " + " ".join(shlex.quote(a) for a in argv)[:200])
return 0, ""
debut = time.time()
code, sortie = pve.run(hote, remote, delai)
if code or montrer:
self.dire(
f" {etiquette} : code {code}"
f" en {int(time.time() - debut)} s"
)
if code:
for ligne in pve.strip_ssh_noise(sortie).strip().splitlines()[-5:]:
self.dire(f" {ligne}")
return code, sortie
def attendre_ssh(self, hote, delai, parent=None):
"""Attend que la machine réponde. Rend les secondes, ou None.
Des connexions COURTES successives : cloud-init régénère les clés
d'hôte et redémarre sshd au premier démarrage, ce qui tuerait une
session longue.
`parent` : si l'hôte qui HÉBERGE la machine attendue cesse de
répondre, on abandonne tout de suite. Constaté : l'étage 1 a redémarré
pendant l'installation de l'étage 4, ce qui a éteint les étages 2, 3 et
4 d'un coup ; la descente a attendu son délai entier — quarante
minutes — un ssh qui ne pouvait plus aboutir, puis a rendu « jamais
joignable en ssh ». Le diagnostic était faux : la machine n'était pas
lente, sa MAISON n'existait plus.
"""
if self.dry_run:
return 0
debut = time.time()
# SANS privilège : wrap_privilege transformerait « true » en
# « sudo sh -c true », et un sudo qui réclame un mot de passe — le
# temps que cloud-init écrive /etc/sudoers.d — se lisait « jamais
# joignable en ssh ». Le transport marchait ; c'est le diagnostic qui
# était faux.
sonde = dict(hote, sudo="")
sonde_parent = dict(parent, sudo="") if parent else None
while time.time() - debut < delai:
code, _o = pve.run(sonde, "true", 60)
if code == 0:
return int(time.time() - debut)
if sonde_parent is not None:
code_parent, _p = pve.run(sonde_parent, "true", 60)
if code_parent != 0:
self.dire(
f" ✗ l'hôte {sonde_parent['target']} ne répond"
" plus : l'attente n'aboutira pas"
)
return None
time.sleep(15)
return None
def redemarrer_et_verifier(self, hote, parent=None, nom=""):
"""Redémarre, attend le retour, exige le noyau voulu.
L'installation pose le noyau sans redémarrer — lancée par ssh, un
reboot couperait sa session et ferait passer l'installation pour un
échec. Sans ce redémarrage, la machine reste sur le noyau cloud de
Debian, dépouillé de tout netfilter : ni pont NAT, ni invité.
Ce que « le bon noyau » veut dire appartient à la pile :
`noyau_convient`.
"""
if self.dry_run:
print(" reboot, puis btime changé ET le noyau attendu")
return True
# L'instant de démarrage AVANT : le noyau seul ne prouve rien. Rejoué
# sur un étage déjà installé, le script est idempotent et ne redémarre
# pas ; vingt secondes après l'ordre, sshd répond encore et la machine
# tourne DÉJÀ sur -pve. On validait donc un redémarrage qui n'avait pas
# eu lieu, et l'étape suivante tombait sur une machine en train de
# s'éteindre — avec un diagnostic sans rapport. Même piège que celui
# corrigé dans le suivi d'installation, refait ici.
_c, out = pve.run(dict(hote, sudo=""), "stat -c %Y /proc/1", 60)
avant = pve.strip_ssh_noise(out).strip()
pve.run(hote, "systemctl reboot", 60)
debut = time.time()
while time.time() - debut < self.delai("reboot"):
time.sleep(20)
code, out = pve.run(
dict(hote, sudo=""), "uname -r; stat -c %Y /proc/1", 60
)
lignes = pve.strip_ssh_noise(out).strip().splitlines()
if code or len(lignes) < 2:
continue
noyau, apres = lignes[0].strip(), lignes[-1].strip()
if not self.noyau_convient(noyau):
continue
if avant and apres == avant:
continue # elle n'a pas encore redémarré
self.dire(
f" noyau {noyau} après {int(time.time() - debut)} s"
)
return True
# Une seule reprise, et seulement si le parent peut la donner : la
# machine est peut-être bloquée dans son micrologiciel, où un
# redémarrage demandé à l'invité ne la sortira jamais. Une fois, pas
# deux — une boucle de rallumage cacherait un vrai échec.
if parent and nom and self.rallumer_a_froid(parent, nom):
self.dire(" ↻ rallumée à froid par son parent")
return self.redemarrer_et_verifier(hote)
self.dire(" ✗ pas revenue sur le noyau attendu")
return False
def preparer_systeme(self, hote):
"""Gel de cloud-init et réparation de /etc/hosts. Vrai pour TOUTE pile.
`manage_etc_hosts: True` fait réécrire /etc/hosts à chaque démarrage :
le nom de la machine cesse de résoudre vers son adresse réelle, et les
services qui s'y fient tombent sans dire pourquoi.
"""
if self.dry_run:
print(" gel cloud-init + /etc/hosts")
return True
_c, out = pve.run(
dict(hote, sudo=""), 'printf %s "$SSH_CONNECTION"', 30
)
ip = pve.ssh_server_ip(out)
if not ip:
self.dire(" ✗ adresse d'accès inconnue")
return False
for cmd, etiquette in (
(pve.cloud_hosts_freeze_cmd(), "gel cloud-init"),
(pve.hosts_repair_cmd(ip), "/etc/hosts"),
):
code, sortie = self.executer(
hote, cmd, self.delai("reparation"), etiquette
)
if code or "-KO" in pve.strip_ssh_noise(sortie):
self.dire(f" ✗ {etiquette}")
return False
# Ce « return True » manquait, et l'étape échouait donc SANS RIEN
# DIRE : « ✗ étage 1 systeme » et pas une ligne de cause. Une fonction
# qui rend None là où l'appelant attend un booléen ne ment pas à
# moitié — elle dit « non ».
return True
def creer_etage1(self, res):
"""Une VM locale, par la CLI QEMU/KVM. Le seul étage sur du métal."""
nom = self.nom_etage(1)
# SOUS SUDO, comme le menu le fait : le dossier des images
# appartient à root en 755 sur une installation ordinaire de libvirt,
# et la CLI s'arrête à l'étape 1 sur « Permission refusée » avant
# d'avoir rien créé. Jamais à blanc — un essai qui n'écrit rien n'a
# aucune raison de demander un mot de passe.
argv = ([] if self.dry_run else ["sudo"]) + [
os.path.join(RACINE, ".venv.erplibre/bin/python"),
os.path.join(RACINE, "script/qemu/deploy_qemu.py"),
"--distro",
self.DISTRO,
"--name",
nom,
"--vcpus",
str(res["vcpu"]),
"--memory",
str(res["ram"]),
"--disk-size",
f"{res['disque']}G",
]
pub = cle_publique()
if pub:
argv += ["--ssh-key", pub]
argv += drapeaux_cache()
if self.dry_run:
print(" " + " ".join(shlex.quote(a) for a in argv))
return nom
res_proc = subprocess.run(argv, timeout=DELAIS["creation"] * 3)
if res_proc.returncode:
self.dire(" ✗ la CLI QEMU/KVM a échoué")
return None
# L'entrée ~/.ssh/config, que la CLI n'écrit PAS. Sans elle,
# « ssh deep-pve-1 » rend « Name or service not known » et la descente
# attendait son plein délai avant de conclure « jamais joignable » —
# sur une VM qui répondait parfaitement à son adresse. Vécu au premier
# lancement réel.
from script.todo.todo import TODO
todo = TODO.__new__(TODO)
ip = todo._qemu_vm_ip_now(nom)
if not ip:
self.dire(f" ✗ {nom} créée mais sans adresse")
return None
self.dire(f" {nom} : {ip}")
prive = cle_publique()[:-4] if cle_publique() else None
todo._write_ssh_config_entry(
[nom], "erplibre", ip, identity_file=prive
)
return nom
@staticmethod
def uuid_libvirt(nom):
"""L'UUID du domaine `nom`, ou "". C'est lui qui l'identifie.
Un nom se réutilise ; un UUID non. Sans lui, « --detruire » effaçait
« deep-pve-1 » quel qu'il soit — la VM d'une descente précédente qu'on
voulait garder, ou une machine sans rapport qui porte ce nom.
"""
try:
res = subprocess.run(
["sudo", "-n", "virsh", "domuuid", nom],
capture_output=True,
text=True,
timeout=60,
)
except (OSError, subprocess.SubprocessError):
return ""
return "" if res.returncode else res.stdout.strip()
def parcourir(self):
# Sans racine, le premier étage est une VM qu'on crée en local. Avec
# une racine, TOUS les étages sont des enfants — le premier compris.
parent = self.racine
parent_alias = (self.racine or {}).get("target", "")
for res in self.plan["niveaux"]:
niveau = res["niveau"]
self.niveau_courant = niveau
debut = time.time()
etage = {
"niveau": niveau,
"ressources": res,
"etape": "creation",
"ok": False,
}
self.dire(
f" ── étage {niveau} : {res['vcpu']} vCPU,"
f" {res['ram']} Mo, {res['disque']} Go"
)
if parent is None:
nom = self.creer_etage1(res)
if not nom:
self.etages.append(etage)
self.interrompu = True
break
alias = nom
etage["nom"] = nom
# « cree » : NOUS l'avons faite. C'est de ce seul champ que
# dépend le droit de la détruire. Avant lui, ce qui protégeait
# une machine que nous n'avions pas créée était un effet de
# bord — l'absence des clés qu'une descente écrit.
etage["cree"] = True
# L'UUID, et non le nom : c'est de lui que « --detruire » se
# servira. Un nom se réutilise, un UUID non.
etage["uuid"] = self.uuid_libvirt(nom)
# Le domaine libvirt existe : le rapport doit exister aussi.
self._sauver(etage)
else:
prepare = self.preparer_parent(parent)
if not prepare:
etage["etape"] = "parent"
self.etages.append(etage)
self.interrompu = True
break
def noter(
numero,
etage=etage,
parent_alias=parent_alias,
niveau=niveau,
):
# « identite » et non « vmid » : un VMID chez Proxmox,
# un UUID libvirt ailleurs. Le champ ancien est gardé pour
# les rapports écrits avant ce changement.
etage["identite"] = str(numero)
etage["vmid"] = numero
etage["parent_alias"] = parent_alias
etage["cree"] = True
# Le nom est ÉCRIT, non déduit du numéro d'étage à la
# relecture : si nom_etage change un jour, un rapport
# ancien désignerait des machines qui ne sont pas les
# siennes.
etage["nom"] = self.nom_etage(niveau)
self._sauver(etage)
identite, adresse = self.creer_enfant(
parent, niveau, res, prepare, noter
)
if identite is None:
self.etages.append(etage)
self.interrompu = True
break
etage["identite"] = str(identite)
etage["vmid"] = identite
etage["cree"] = True
# Le parent est noté AVANT tout autre contrôle : c'est le seul
# enregistrement de ce qu'on vient de créer, et --detruire s'en
# sert. Sans lui, une VM abandonnée juste après « qm create »
# n'était nommée nulle part.
etage["parent_alias"] = parent_alias
self._sauver(etage)
alias = self.alias_etage(niveau, parent_alias)
if not self.dry_run:
self.ecrire_alias(alias, adresse, parent_alias)
cible = {"target": alias, "sudo": "sudo ", "jump": ""}
etage["alias"] = alias
etage["etape"] = "ssh"
attente = self.attendre_ssh(cible, self.delai("ssh"), parent)
if attente is None:
self.dire(" ✗ jamais joignable en ssh")
self.etages.append(etage)
self.interrompu = True
break
etage["ssh_secondes"] = attente
self.dire(f" ssh après {attente} s")
# Les quatre étapes qui suivent le ssh. « controle » est la
# sixième et elle est NOUVELLE : sans elle, un étage était déclaré
# terminé sans qu'on sache s'il pouvait héberger le suivant.
for etape, action in (
("install", lambda: self.installer(cible)),
(
"reboot",
lambda: self.redemarrer_et_verifier(
cible, parent, etage.get("nom", "")
),
),
("systeme", lambda: self.preparer_systeme(cible)),
("services", lambda: self.remettre_debout(cible)),
("controle", lambda: self.controler(cible)),
):
etage["etape"] = etape
self._sauver(etage)
if not action():
self.etages.append(etage)
return self.rapport(interrompu=True)
# En dry-run, aucune étape n'a été mesurée : les marquer
# « atteintes » produisait un rapport indiscernable d'une vraie
# réussite, JSON compris, et un code de sortie 0.
etage["etape"] = "plan" if self.dry_run else "termine"
etage["ok"] = not self.dry_run
etage["secondes"] = int(time.time() - debut)
self.etages.append(etage)
self._sauver()
self.dire(f" ✓ étage {niveau} en {etage['secondes']} s")
parent, parent_alias = cible, alias
return self.rapport(interrompu=self.interrompu)
def ecrire_alias(self, alias, adresse, parent_alias):
"""Une entrée ~/.ssh/config pour joindre l'enfant à travers le parent."""
from script.todo.todo import TODO
todo = TODO.__new__(TODO)
prive = cle_publique()[:-4] if cle_publique() else None
todo._write_ssh_config_entry(
[alias],
"erplibre",
adresse,
proxy_jump=parent_alias or None,
identity_file=prive,
)
def _etat(self, interrompu, en_cours=None):
"""Le rapport, à cet instant. `en_cours` : l'étage pas encore rangé."""
etages = list(self.etages)
if en_cours is not None and en_cours not in etages:
etages.append(en_cours)
return {
# La racine EMPRUNTÉE, si la descente en avait une. Hors de
# « etages » : elle n'est pas un étage atteint, et l'y mettre
# décalait de un le compte et le code de sortie.
"racine": (
{
"alias": self.racine.get("target"),
"profondeur": self.profondeur_racine,
"cree": False,
}
if self.racine
else None
),
# L'outil qui a écrit ce rapport. Sans lui, « deep_qemu
# --detruire » prenait le rapport le plus récent — qui pouvait
# être celui d'une descente Proxmox — et détruisait d'après lui.
"outil": self.OUTIL,
"demandee": self.plan["demandee"],
"atteignable": self.plan["atteignable"],
"atteinte": sum(1 for e in etages if e.get("ok")),
"interrompu": interrompu,
# Sans ce champ, un rapport d'essai à blanc se lisait comme une
# descente réussie — et « --detruire » s'en servait.
"dry_run": self.dry_run,
"etages": etages,
}
def _sauver(self, en_cours=None):
"""Écrit le rapport PARTIEL, dès qu'une VM existe.
Il ne s'écrivait qu'à la fin. Une descente tuée au quatrième étage —
c'est arrivé — laissait quatre machines réelles et « --detruire »
répondait « aucun rapport : rien à défaire » : le seul enregistrement
du couple (alias du parent, VMID) mourait avec le processus. Il fallait
alors les retrouver et les détruire à la main, c'est-à-dire par leur
nom, ce que tout le reste de ce fichier s'applique à ne pas faire.
Marqué « interrompu » jusqu'au bout : un rapport partiel ne doit jamais
se lire comme une descente terminée.
"""
if self.dry_run or not self.chemin_json:
return
temporaire = self.chemin_json + ".tmp"
try:
etat = self._etat(interrompu=True, en_cours=en_cours)
# Le PID de la descente qui écrit : c'est ce qui distingue un
# rapport ABANDONNÉ d'un rapport en cours d'écriture. Le rapport
# final, lui, n'en porte pas — la descente est finie.
etat["pid"] = os.getpid()
with open(temporaire, "w", encoding="utf-8") as fh:
json.dump(etat, fh, indent=2)
os.replace(temporaire, self.chemin_json)
except OSError as err:
self.dire(f" ⚠ rapport non écrit : {err}")
def rapport(self, interrompu=False):
etat = self._etat(interrompu)
atteint = etat["atteinte"]
print("")
if self.dry_run:
self.dire(
f" plan annoncé sur {len(self.etages)} étage(s) —"
" rien n'a été créé"
)
else:
self.dire(
f" profondeur atteinte : {atteint} / {self.plan['demandee']}"
)
# Deux causes très différentes rendaient le même « 5 / 10 » : la
# machine trop petite pour dix, ou un étage tombé en route. La
# première n'est pas un défaut du code, la seconde si.
if atteint == self.plan["atteignable"] < self.plan["demandee"]:
self.dire(
f" (plan borné à {self.plan['atteignable']} par le"
f" {self.plan['arret']} : tout le plan a tenu)"
)
elif atteint < self.plan["atteignable"]:
self.dire(
f" (le plan annonçait {self.plan['atteignable']} :"
" un étage est tombé, voir plus haut)"
)
for e in self.etages:
if self.dry_run:
marque, detail = "·", "plan"
else:
marque = "✓" if e["ok"] else "✗"
detail = (
f"{e.get('secondes', '—')} s" if e["ok"] else e["etape"]
)
self.dire(f" {marque} étage {e['niveau']:2d} {detail}")
return etat
def _lance_une_descente(pid):
"""`pid` exécute-t-il UN des scripts de descente — pas seulement le
nomme-t-il ?
Par ARGUMENT, jamais par sous-chaîne. Un « pgrep -f deep_proxmox.py » posé
dans une boucle de surveillance donne un shell dont la ligne de commande
contient le motif, et le contrôle comptait ce shell comme une descente —
deux faux positifs sur trois.
Et par NOM DE FICHIER, pas par suffixe. « endswith » prenait
« test_longtest_install_nixos.py » pour « install_nixos.py » : le fichier
de tests se déclarait descente en cours, et « --detruire » refusait de
travailler tant qu'il tournait. Le basename ne confond pas deux fichiers
dont l'un finit comme l'autre, et reconnaît toujours le chemin complet
qu'un interpréteur reçoit.
"""
try:
with open(f"/proc/{int(pid)}/cmdline", "rb") as fh:
arguments = fh.read().split(b"\0")
except (OSError, ValueError):
return False
# LES scripts, tous : deux tests longs se disputent la RAM, le disque et
# ~/.ssh/config aussi sûrement que deux descentes de la même pile.
attendus = {nom.encode() for nom in SCRIPTS}
return any(os.path.basename(a) in attendus for a in arguments)
def descente_vivante(pid):
"""Le processus `pid` est-il une descente EN COURS ?
Le PID seul ne suffirait pas : les numéros se réutilisent, et rien ne dit
qu'un rapport vieux d'une semaine ne porte pas le PID d'un shell
d'aujourd'hui. La ligne de commande est donc lue aussi.
"""
return bool(pid) and _lance_une_descente(pid)
def autre_descente():
"""Les PID des AUTRES descentes vivantes. Le sien est exclu.
Le garde-fou du rapport — un PID dans le fichier — ne protège que les
descentes lancées APRÈS son écriture : celle qui tournait déjà avait
chargé l'ancien module en mémoire et n'écrira jamais de PID. Constaté sur
une descente réelle de dix étages, à l'étage 4. Ce contrôle-ci ne dépend
d'aucun rapport : détruire pendant qu'une descente tourne n'est jamais
juste, quel que soit le rapport choisi.
/proc plutôt que pgrep : « pgrep -f deep_proxmox » attrape le shell qui
l'invoque, et on croit alors voir survivre un processus qui n'existe pas.
"""
moi = os.getpid()
vivants = []
try:
entrees = os.listdir("/proc")
except OSError:
return vivants
for entree in entrees:
if not entree.isdigit() or int(entree) == moi:
continue
if _lance_une_descente(entree):
vivants.append(int(entree))
return vivants
def joindre_racine(cible, jump=""):
"""Le dict d'hôte d'une racine empruntée, ou None si elle ne répond pas.
`sudo` est DÉDUIT, pas supposé : sur un hôte joint en root, préfixer les
commandes de « sudo » échoue là où l'image n'en a pas, et sur un hôte
joint en utilisateur, ne pas le mettre échoue partout.
"""
hote = {"target": cible, "jump": jump or "", "sudo": ""}
code, out = pve.run(hote, "id -u", 60)
if code:
dire(f" ✗ {cible} : injoignable en ssh.")
return None
if pve.strip_ssh_noise(out).strip() != "0":
hote["sudo"] = "sudo "
code, _o = pve.run(hote, "true", 60)
if code:
dire(f" ✗ {cible} : sudo demande un mot de passe.")
return None
return hote
def profondeur_de(cible):
"""La profondeur d'imbrication de `cible`, d'après sa chaîne de rebonds.
C'est la seule mesure dont on dispose de l'extérieur, et elle est exacte
pour les hôtes que nous avons déployés : c'est nous qui écrivons ces
entrées, un ProxyJump par étage.
"""
try:
from script.todo.todo import TODO
return nesting.depth_from_jumps(TODO._ssh_jump_depth(cible))
except Exception: # noqa: BLE001 - une profondeur inconnue vaut 1
return 1
def mener(argv, description, famille, classe, couts=None):
"""La ligne de commande, le plan, la descente et le rapport.
Identique d'une pile à l'autre à quatre choses près : ce qu'on annonce, la
famille — qui nomme les fichiers et filtre les rapports —, la classe qui
porte les verbes, et ce que coûte un étage.
"""
parseur = argparse.ArgumentParser(description=description)
# Trois par défaut, et c'est une MESURE, pas une prudence : les trois
# premiers étages coûtent 280, 495 et 1 064 secondes — une demi-heure en
# tout. Le quatrième en a coûté 7 h 18 d'installation et 4 h 20 d'amorçage
# sur la même machine. Un défaut à dix promettait ce qu'aucune machine ne
# peut tenir ; la profondeur reste un paramètre, et c'est à qui la demande
# de savoir ce qu'il demande.
parseur.add_argument("--depth", type=int, default=3)
parseur.add_argument("--dry-run", action="store_true")
parseur.add_argument("--detruire", action="store_true")
# Partir d'un hôte qu'on POSSÈDE DÉJÀ. Créer une VM de tête pour héberger
# un hyperviseur qu'on a sous la main coûte cinq minutes et un étage
# d'imbrication — donc de la lenteur — pour rien.
parseur.add_argument(
"--hote",
default="",
help="partir d'un hôte existant (alias ssh ou user@adresse)"
" au lieu de créer une VM de premier étage",
)
parseur.add_argument(
"--jump", default="", help="rebond ssh pour joindre --hote"
)
args = parseur.parse_args(argv)
journal = os.path.expanduser(
f"~/.erplibre/longtest/{famille.nom_base}"
f"-{time.strftime('%Y%m%d-%H%M%S')}.log"
)
os.makedirs(os.path.dirname(journal), exist_ok=True)
if args.detruire:
# « --dry-run » était ignoré ici : la prudence naturelle avant une
# destruction détruisait pour de vrai.
return detruire(famille, journal, dry_run=args.dry_run)
racine, profondeur_racine = None, 0
if args.hote:
racine = joindre_racine(args.hote, args.jump)
if racine is None:
return 1
profondeur_racine = profondeur_de(args.hote)
# La capacité de la RACINE, pas celle d'ici. Dimensionner le plan sur
# la machine locale quand les étages vivent ailleurs annoncerait des
# étages qui ne tiennent pas.
coeurs, ram, disque = capacite_distante(racine)
if not coeurs:
print(f"\n ✗ {args.hote} : capacité illisible.\n")
return 1
print(f"\n racine : {args.hote}, déjà au niveau {profondeur_racine}")
else:
coeurs, ram, disque = capacite_hote()
ou = args.hote or "machine locale"
print(
f"\n {ou} : {coeurs} cœurs, {ram} Mo disponibles,"
f" {disque} Go de disque"
)
plan = nesting.nesting_plan(args.depth, coeurs, ram, disque, couts)
print(f"\n {'étage':>5} {'vCPU':>4} {'RAM':>9} {'disque':>8}")
for n in plan["niveaux"]:
print(
f" {n['niveau']:>5} {n['vcpu']:>4} {n['ram']:>6} Mo"
f" {n['disque']:>5} Go"
)
if plan["arret"]:
# Les TROIS plafonds, pas seulement celui qui borne : sans eux on
# ajoute la ressource nommée sans savoir de combien, ni laquelle
# bornera ensuite.
plafonds = " · ".join(
f"{nom} {valeur}" for nom, valeur in plan["plafonds"].items()
)
print(
f"\n ⚠ demandée {plan['demandee']}, atteignable"
f" {plan['atteignable']} — c'est le {plan['arret']} qui borne"
f"\n profondeur permise par chaque ressource : {plafonds}"
)
if not plan["niveaux"]:
if args.depth < 1:
print(f"\n profondeur demandée : {args.depth} — rien à faire.\n")
return 0
print("\n ✗ pas même un étage ne tient sur cette machine.\n")
return 1
print(f"\n journal : {journal}")
if args.dry_run:
print(" --dry-run : rien ne sera créé.\n")
chemin = journal[:-4] + ("-dryrun.json" if args.dry_run else ".json")
descente = classe(
plan, journal, args.dry_run, chemin, racine, profondeur_racine
)
# La racine est-elle en état d'héberger ? Le même contrôle que celui de
# fin d'étage — un hôte emprunté n'a pas été préparé par nous, et rien ne
# garantit que sa pile est debout.
if racine and not args.dry_run and not descente.controler(racine):
print(f"\n ✗ {args.hote} ne peut pas héberger d'étage.\n")
return 1
rapport = descente.parcourir()
with open(chemin, "w", encoding="utf-8") as fh:
json.dump(rapport, fh, indent=2)
print(f"\n rapport : {chemin}\n")
# En essai à blanc, c'est le PLAN qui est complet ou non — aucune
# profondeur n'a été atteinte. Hors essai, « non nul » ne suffisait pas :
# une descente morte au deuxième étage sur dix rendait 0.
if args.dry_run:
return 0 if rapport["atteignable"] == rapport["demandee"] else 1
return 0 if rapport["atteinte"] == rapport["demandee"] else 1
class Famille:
"""Ce qu'une pile doit dire d'elle aux fonctions qui détruisent.
Trois choses, et pas une de plus : son nom d'outil — qui filtre les
rapports —, le préfixe de ses machines, et comment on défait une machine
imbriquée chez son parent.
"""
def __init__(self, outil, nom_base, detruire_une):
self.outil = outil
self.nom_base = nom_base
self.detruire_une = detruire_une
def dernier_rapport(outil="", prefixe=""):
"""Le rapport le plus récent qui NOMME quelque chose à défaire, ou {}.
C'est le SEUL enregistrement de ce que la descente a créé : un couple
(alias du parent, VMID) par étage. Détruire d'après lui, et non d'après
les noms, est toute la différence entre défaire son propre travail et
effacer une machine qui se trouve porter un nom voisin.
Deux rapports sont ÉCARTÉS, et chacun l'est pour un accident précis :
* celui d'une descente VIVANTE. Depuis que le rapport s'écrit VM par VM,
la descente en cours en a un sur le disque, et c'est le plus récent :
« --detruire » aurait détruit l'arbre sous le processus qui installait
encore, emportant des heures de mesure. Avant, la descente en cours
n'avait aucun rapport et la question ne se posait pas — le correctif a
créé le danger.
* celui qui n'a RIEN créé. Un second lancement qui meurt à l'étage 1 —
« le disque existe déjà » — écrit un rapport vide sous un horodatage
plus tardif. Il masquait le partiel qui nommait les VM réelles :
« 0 VM imbriquée(s) », puis « virsh undefine --remove-all-storage » sur
l'étage 1, dont le disque contient les étages 2 et suivants — jamais
arrêtés, jamais nommés.
"""
dossier = os.path.expanduser("~/.erplibre/longtest")
try:
fichiers = sorted(
f for f in os.listdir(dossier) if f.endswith(".json")
)
except OSError:
return {}
for nom in reversed(fichiers):
chemin = os.path.join(dossier, nom)
try:
with open(chemin, encoding="utf-8") as fh:
rapport = json.load(fh)
except (OSError, ValueError):
continue
if rapport.get("dry_run"):
continue # un plan n'a rien créé
# Le rapport d'une AUTRE pile. Le dossier et le motif « *.json » sont
# partagés : sans ce filtre, « deep_qemu --detruire » prenait le
# rapport le plus récent — pouvant être celui d'une descente Proxmox —
# et lançait « virsh undefine » d'après lui.
#
# Un rapport écrit AVANT que ce champ existe n'a pas d'outil. Le
# refuser le rendrait indéfaisable, et laisser passer ramènerait le
# danger : c'est le NOM DE FICHIER qui tranche, puisqu'il porte déjà
# le préfixe de la pile — « deep-pve-20260828-…json ».
if outil:
declare = rapport.get("outil")
if declare != outil and not (
declare is None and prefixe and nom.startswith(prefixe)
):
continue
if descente_vivante(rapport.get("pid")):
dire(f" ⏳ descente EN COURS ({rapport['pid']}) : {nom} ignoré")
continue
if not (rapport.get("etages") or []):
continue # rien créé : ne pas masquer un rapport qui nomme des VM
rapport["fichier"] = chemin
return rapport
return {}
def identite_de(etage):
"""L'identifiant de la machine SUR SON PARENT, ou "".
Un VMID chez Proxmox, un UUID libvirt ailleurs — d'où une chaîne, et non
un entier. « vmid » est l'ancien nom du champ : les rapports écrits avant
ce changement le portent encore, et ils doivent rester défaisables.
"""
valeur = etage.get("identite") or etage.get("vmid")
return "" if valeur in (None, "") else str(valeur)
def a_defaire(rapport, nom_base=""):
"""[(niveau, parent_alias, vmid, nom)] du plus PROFOND au plus haut.
Trié sur le niveau LU dans le rapport, pas déduit du nom. La version
d'avant comptait les « + » de l'alias — or `alias_etage` remplace le « + »
du parent par un « - », donc chaque alias en portait exactement UN et le
tri ne triait rien. La destruction partait du plus HAUT : « qm destroy
--purge » sur l'étage 2 emportait le disque contenant les étages 3 et
suivants, sans les avoir arrêtés ni nommés.
"""
etages = [
e
for e in (rapport.get("etages") or [])
if identite_de(e)
and e.get("parent_alias")
# « cree » est le seul champ qui dise que la machine est à NOUS. Les
# deux autres conditions ne protégeaient que par accident : elles
# tenaient parce que rien ne décrivait un hôte emprunté. Depuis qu'une
# descente peut PARTIR d'une machine existante, il faut le dire.
and e.get("cree", True)
]
etages.sort(key=lambda e: -int(e["niveau"]))
return [
(
int(e["niveau"]),
e["parent_alias"],
identite_de(e),
# Le nom ÉCRIT par la descente. Le déduire du numéro d'étage
# supposait que nom_etage ne changera jamais — un rapport ancien
# aurait alors nommé des machines qui ne sont pas les siennes.
# Le nom ÉCRIT par la descente. Le déduire du numéro d'étage
# supposait que nom_etage ne changera jamais — un rapport ancien
# aurait alors nommé des machines qui ne sont pas les siennes.
e.get("nom")
or (nom_base and nom_etage(int(e["niveau"]), nom_base)),
)
for e in etages
]
def detruire_etage1(journal, nom, dry_run=False, attendu=None, cree=True):
"""Le domaine libvirt du premier étage — le SEUL qui en soit un.
La boucle d'avant tournait sur trente niveaux avec une condition morte, et
sa branche « niveau == 1 » était vraie même quand la descente n'avait
jamais rien créé : « virsh undefine --remove-all-storage » partait alors
sur un domaine qui pouvait être n'importe quoi, sortie capturée, sans un
mot.
`attendu` : l'UUID que le rapport a noté à la création. C'est LUI qui
identifie la machine, pas son nom. Un nom se réutilise — la VM d'une
descente précédente qu'on voulait garder, ou une machine sans rapport qui
porte celui-là — et « --remove-all-storage » efface un disque pour de bon.
Un rapport ancien n'a pas d'UUID : on procède alors comme avant, par le
nom, faute de mieux, mais en le disant.
"""
# `nom` est OBLIGATOIRE : une fonction qui lance
# « virsh undefine --remove-all-storage » ne devine pas sa cible. Elle le
# faisait — `nom_etage(1)` — et le repli désignait la machine numéro 1 de
# la pile, quelle que soit celle dont parlait le rapport.
existe = subprocess.run(
["sudo", "-n", "virsh", "dominfo", nom],
capture_output=True,
text=True,
)
if existe.returncode:
dire(f" — {nom} : aucun domaine libvirt", journal)
return True
if attendu:
vu = Descente.uuid_libvirt(nom)
if vu != attendu:
dire(
f" ✗ {nom} : UUID {vu or '—'} au lieu de {attendu} —"
" ce n'est PAS notre machine, rien touché",
journal,
)
return False
elif cree:
dire(
f" ⚠ {nom} : rapport sans UUID, identifié par son NOM", journal
)
else:
# Ni UUID, ni preuve que la machine est à nous : on ne touche à rien.
# Une descente PARTIE d'un hôte existant n'a jamais d'UUID libvirt
# local ; le repli par le nom aurait effacé un homonyme, disques
# compris, avec « --remove-all-storage ».
dire(
f" — {nom} : pas créé par cette descente, rien touché", journal
)
return True
if dry_run:
dire(
f" [à blanc] virsh undefine {nom} --remove-all-storage", journal
)
return True
subprocess.run(
["sudo", "virsh", "destroy", nom], capture_output=True, text=True
)
res = subprocess.run(
[
"sudo",
"virsh",
"undefine",
nom,
"--nvram",
"--remove-all-storage",
],
capture_output=True,
text=True,
)
if res.returncode:
dire(
f" ✗ virsh undefine {nom} : {res.stderr.strip()[:160]}", journal
)
return False
dire(f" ✓ {nom} (libvirt)", journal)
return True
def detruire(famille, journal=None, dry_run=False):
"""Défait ce que le DERNIER rapport dit avoir créé, du plus profond.
Rien d'autre. La version d'avant prenait toute entrée ~/.ssh/config dont
le nom contenait « deep-pve », puis sur son rebond détruisait toute VM
dont le nom contenait « deep-pve » — une machine de labo appelée
« deep-pve-lab » sur un hyperviseur de production tombait dedans.
"""
# Avant tout : refuser tant qu'une descente tourne. Elle installe encore
# sur les machines qu'on s'apprête à détruire, et son rapport peut être
# celui qu'on vient de choisir.
autres = autre_descente()
if autres:
dire(
f" ⛔ une descente tourne ({', '.join(map(str, autres))}) :"
" rien ne sera détruit.",
journal,
)
dire(" Attendre qu'elle finisse, ou l'arrêter d'abord.", journal)
return 1
rapport = dernier_rapport(famille.outil, famille.nom_base)
if not rapport:
dire(" aucun rapport de descente : rien à défaire.", journal)
dire(
" (les entrées ~/.ssh/config orphelines : menu de nettoyage)",
journal,
)
return 0
liste = a_defaire(rapport, famille.nom_base)
dire(f" rapport : {rapport.get('fichier')}", journal)
dire(f" {len(liste)} VM imbriquée(s) + l'étage 1 :", journal)
for niveau, parent_alias, identite, nom in liste:
dire(
f" étage {niveau:2d} {nom} ({identite}) sur {parent_alias}",
journal,
)
etage1_nom = next(
(
e.get("nom")
for e in (rapport.get("etages") or [])
if int(e.get("niveau", 0)) == 1
),
None,
)
dire(
f" étage 1 {etage1_nom or nom_etage(1, famille.nom_base)}"
" (libvirt)",
journal,
)
if dry_run:
dire("\n --dry-run : rien ne sera détruit.", journal)
return 0
# Une confirmation, parce que « --purge » emporte les disques et que le
# menu lançait cette option d'une seule touche.
reponse = input("\n Détruire tout cela ? (tapez OUI) : ").strip()
if reponse != "OUI":
dire(" annulé.", journal)
return 1
faits = sum(
1
for niveau, parent_alias, identite, nom in liste
if famille.detruire_une(parent_alias, identite, nom, journal)
)
# « if not … : faits -= 1 » : un succès de l'étage 1 n'ajoutait RIEN,
# alors que le total est len(liste) + 1. Le décompte était décalé de un
# dans TOUS les cas — une destruction complète annonçait « il reste des
# machines » et sortait 1, si bien que le seul avertissement censé
# prévenir qu'un disque de plusieurs dizaines de Go reste alloué
# s'affichait toujours, et qu'on apprenait à ne plus le lire.
etage1 = next(
(
e
for e in (rapport.get("etages") or [])
if int(e.get("niveau", 0)) == 1
),
{},
)
racine = detruire_etage1(
journal,
attendu=etage1.get("uuid"),
nom=etage1.get("nom") or nom_etage(1, famille.nom_base),
cree=bool(etage1.get("cree", True)),
)
if racine:
faits += 1
retirer_alias(rapport, journal, famille.nom_base)
if racine:
# L'étage 1 est un DISQUE, et tout le reste vit dedans. « virsh
# undefine --remove-all-storage » l'a effacé : les étages injoignables
# — leur parent était éteint — ont disparu avec, qu'on ait pu leur
# parler ou non. Annoncer « il reste des machines » dans ce cas était
# faux dans l'autre sens, et un avertissement faux ne se lit plus.
reste = len(liste) + 1 - faits
dire(
f"\n {len(liste) + 1} / {len(liste) + 1} défait(s)."
+ (
f" ({reste} injoignable(s), emporté(s) avec le disque de"
" l'étage 1.)"
if reste
else ""
),
journal,
)
return 0
dire(
f"\n {faits} / {len(liste) + 1} défait(s)."
" ⚠ l'étage 1 est DEBOUT : ce qu'il contient vit encore.",
journal,
)
return 1
def retirer_alias(rapport, journal=None, nom_base=""):
"""Retire de ~/.ssh/config les entrées de la descente défaite.
Sans cela, elles survivaient aux machines : des entrées mortes dont le
ProxyJump désigne un hôte qui n'existe plus, et qu'on retrouve plus tard
sans savoir à quoi elles servaient.
"""
alias = []
for etage in rapport.get("etages") or []:
# Seulement les nôtres. L'entrée ssh d'un hôte EMPRUNTÉ appartient à
# l'utilisateur : il l'a écrite pour sa propre machine et elle lui sert
# ailleurs.
if not etage.get("cree", True):
continue
nom = etage.get("alias")
if not nom:
# L'étage abandonné avant l'écriture de son alias : le calculer,
# il est déterminé par (niveau, alias du parent).
parent = etage.get("parent_alias")
if parent:
nom = alias_etage(int(etage["niveau"]), parent, nom_base)
if nom and nom not in alias:
alias.append(nom)
if not alias:
return
try:
from script.todo.todo import TODO
TODO.__new__(TODO)._write_ssh_config_entry(
[], "erplibre", "", also_drop=tuple(alias)
)
except Exception as err: # noqa: BLE001 - jamais bloquer la destruction
dire(f" ⚠ entrées ~/.ssh/config non retirées : {err}", journal)