Mathieu Benoit
64a8e6400f
Trois obstacles enchaînés, aucun visible sans une vraie machine. /etc est généré depuis le store : le « tee » d'une unité y rend « Read-only file system », et l'installation échouait à sa DERNIÈRE étape, après que le clone, le venv et un démarrage d'Odoo avaient réussi. ExecStart=/bin/bash rendait 203/EXEC, /bin étant un montage FUSE que systemd ne voit pas ; et le PATH d'une unité n'a pas bash, que réclament les shebangs de run.sh. Déclarée, l'unité est démarrée par la reconstruction — qui a lieu pendant « make install_os », quand la source d'Odoo n'arrive qu'après : une condition la fait sauter plutôt qu'échouer 21 fois de suite. Mesuré : service actif, 8069 servi par lui, login en 303. --- EN --- Three chained obstacles, none visible without a real machine. /etc is generated from the store: « tee » of a unit there returns « Read-only file system », and the install failed at its LAST step, after the clone, the venv and an Odoo start had all succeeded. ExecStart=/bin/bash returned 203/EXEC, /bin being a FUSE mount systemd does not see; and a unit's PATH carries no bash, which run.sh's shebangs ask for. Declared, the unit is started by the rebuild — which happens during « make install_os », while Odoo's source lands later: a condition makes it skip rather than fail 21 times over. Measured: service active, 8069 served by it, login in 303. Assisted-by: Claude Opus 5
427 lines
20 KiB
Python
427 lines
20 KiB
Python
#!/usr/bin/env python3
|
|
# © 2026 TechnoLibre (http://www.technolibre.ca)
|
|
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl)
|
|
"""L'installation des dépendances ERPLibre sur NixOS.
|
|
|
|
Les quatre autres scripts de distribution POSENT des paquets ; celui-ci n'en
|
|
pose aucun. Il dépose une déclaration et demande au système de s'y conformer,
|
|
parce que c'est la seule façon dont une dépendance dure là-bas : ce qui est
|
|
installé à la main vit hors de la configuration et disparaît à la
|
|
reconstruction suivante.
|
|
|
|
Ce que ces tests gardent :
|
|
|
|
- l'aiguillage reconnaît « nixos ». Sans cette branche, install_dev.sh tombe
|
|
dans son « else », appelle le script Debian, et celui-ci sort en erreur dès
|
|
la détection du système — avant même d'essayer un apt-get qui n'existe pas ;
|
|
- les DEUX options qui portent tout le reste sont déclarées. Sans envfs, /bin
|
|
et /usr/bin restent vides : le Makefile force « SHELL := /bin/bash » et
|
|
toute cible échoue avant sa première ligne, tandis que
|
|
lib_python_provider.sh ne cherche l'interpréteur du système qu'en
|
|
/usr/bin/pythonX.Y. Sans nix-ld, aucune roue manylinux ni aucun binaire
|
|
téléchargé ne s'exécute ;
|
|
- la version de Python déclarée répond à celle que le dépôt demande ;
|
|
- le compte du rôle PostgreSQL est substitué, jamais écrit en dur.
|
|
"""
|
|
|
|
import re
|
|
import subprocess
|
|
import unittest
|
|
from pathlib import Path
|
|
|
|
RACINE = Path(__file__).resolve().parents[1]
|
|
MODULE = RACINE / "conf/nixos/erplibre.nix"
|
|
SCRIPT = RACINE / "script/install/install_nixos_dependency.sh"
|
|
AIGUILLAGE = RACINE / "script/install/install_dev.sh"
|
|
|
|
|
|
class LAiguillage(unittest.TestCase):
|
|
def setUp(self):
|
|
self.src = AIGUILLAGE.read_text(encoding="utf-8")
|
|
|
|
def test_nixos_has_its_own_branch(self):
|
|
self.assertIn('"${ID}" == "nixos"', self.src)
|
|
self.assertIn("install_nixos_dependency.sh", self.src)
|
|
|
|
def test_it_is_decided_before_the_debian_fallback(self):
|
|
"""Le « else » de fin appelle le script Debian : une branche placée
|
|
après lui ne serait jamais atteinte."""
|
|
self.assertLess(
|
|
self.src.index('"${ID}" == "nixos"'),
|
|
self.src.rindex("install_debian_dependency.sh"),
|
|
)
|
|
|
|
def test_the_supported_list_names_it(self):
|
|
"""Le message de repli énumère les systèmes supportés : en omettre un
|
|
qu'on supporte fait douter de celui qu'on lit."""
|
|
ligne = [x for x in self.src.splitlines() if "not supported" in x][-1]
|
|
self.assertIn("NixOS", ligne)
|
|
|
|
|
|
class LeScript(unittest.TestCase):
|
|
def setUp(self):
|
|
self.src = SCRIPT.read_text(encoding="utf-8")
|
|
|
|
def test_it_is_valid_shell(self):
|
|
fini = subprocess.run(
|
|
["bash", "-n", str(SCRIPT)], capture_output=True, text=True
|
|
)
|
|
self.assertEqual(0, fini.returncode, fini.stderr)
|
|
|
|
def test_it_is_executable(self):
|
|
"""git saute silencieusement un script sans bit d'exécution, et
|
|
install_dev.sh l'appelle directement."""
|
|
import os
|
|
|
|
self.assertTrue(os.access(SCRIPT, os.X_OK))
|
|
|
|
def test_it_refuses_another_system(self):
|
|
"""Déposer un module NixOS ailleurs ne ferait rien de bon, et le
|
|
« nixos-rebuild » qui suit n'existerait pas."""
|
|
self.assertIn("ID=nixos", self.src)
|
|
|
|
def test_the_import_is_added_once(self):
|
|
"""Relancé, le script ne doit pas empiler les imports : la
|
|
configuration ne compilerait plus."""
|
|
self.assertIn('grep -q "erplibre.nix"', self.src)
|
|
|
|
def test_it_says_when_there_is_no_imports_block(self):
|
|
"""Une configuration sans « imports = [ » laisserait le module mort :
|
|
NixOS ne lit que ce que la configuration importe."""
|
|
self.assertIn("imports = [", self.src)
|
|
self.assertIn("exit 1", self.src)
|
|
|
|
def test_the_python_version_comes_from_the_repository(self):
|
|
"""Une version écrite ici dériverait de .python-odoo-version au
|
|
premier changement."""
|
|
self.assertIn(".python-odoo-version", self.src)
|
|
|
|
def test_it_verifies_what_the_module_promised(self):
|
|
"""Sans /bin/bash, la moindre cible make échoue avant sa première
|
|
ligne : le dire ici plutôt qu'une heure plus tard, ailleurs."""
|
|
for chemin in ("/bin/bash", "/usr/bin/env"):
|
|
self.assertIn(chemin, self.src)
|
|
|
|
|
|
class LeModule(unittest.TestCase):
|
|
def setUp(self):
|
|
self.src = MODULE.read_text(encoding="utf-8")
|
|
|
|
def test_the_two_hinges_are_declared(self):
|
|
"""envfs pour /bin et /usr/bin, nix-ld pour les binaires étrangers :
|
|
sans l'une des deux, rien de ce dépôt ne fonctionne."""
|
|
self.assertIn("services.envfs.enable = true;", self.src)
|
|
self.assertIn("programs.nix-ld.enable = true;", self.src)
|
|
|
|
def test_what_compiles_here_is_also_given_to_the_loader(self):
|
|
"""Un module compilé sur place n'a pas de RPATH : son « .so » ne
|
|
retrouve sa bibliothèque à l'IMPORT que par LD_LIBRARY_PATH, donc par
|
|
ce que nix-ld déclare. Déclarer l'en-tête sans la bibliothèque fait
|
|
réussir la compilation et échouer l'import."""
|
|
entetes = ("openldap", "cups", "libmysqlclient")
|
|
loader = self.src.split("programs.nix-ld.libraries")[1].split("];")[0]
|
|
for lib in entetes:
|
|
with self.subTest(lib=lib):
|
|
self.assertIn(lib, loader)
|
|
|
|
def test_pg_config_is_its_own_derivation(self):
|
|
"""Il n'est ni dans postgresql ni dans sa sortie « .dev », et
|
|
psycopg2 s'arrête sur « pg_config executable not found »."""
|
|
self.assertIn("postgresql.pg_config", self.src)
|
|
|
|
def test_the_dynamic_loader_gets_what_the_wheels_ask(self):
|
|
"""Une roue manylinux qui ne trouve pas sa bibliothèque échoue à
|
|
l'IMPORT, pas à l'installation : bien plus tard, et sans rapport
|
|
apparent avec pip."""
|
|
for lib in ("libpq", "libxml2", "libxslt", "openssl", "zlib"):
|
|
with self.subTest(lib=lib):
|
|
self.assertIn(lib, self.src)
|
|
|
|
def test_the_python_matches_what_the_repository_wants(self):
|
|
voulu = (RACINE / ".python-odoo-version").read_text().strip()
|
|
majeur, mineur = voulu.split(".")[:2]
|
|
self.assertIn(f"python{majeur}{mineur}", self.src)
|
|
|
|
def test_the_database_role_is_substituted(self):
|
|
"""Le nom du compte varie d'un déploiement à l'autre ; l'écrire en dur
|
|
donnerait un rôle qui ne correspond à personne."""
|
|
self.assertIn("@EL_USER@", self.src)
|
|
self.assertIn("ensureClauses.superuser = true;", self.src)
|
|
|
|
def test_the_placeholder_is_the_one_the_script_replaces(self):
|
|
script = SCRIPT.read_text(encoding="utf-8")
|
|
for marque in set(re.findall(r"@[A-Z_]+@", self.src)):
|
|
with self.subTest(marque=marque):
|
|
self.assertIn(marque, script)
|
|
|
|
def test_what_npm_cannot_install_is_declared_instead(self):
|
|
"""Les quatre autres scripts posent lessc et rtlcss par « npm install
|
|
-g ». Ici le préfixe npm EST le store, en lecture seule : le geste
|
|
échoue. nixpkgs porte les deux, et une déclaration ne s'installe
|
|
pas — elle tient."""
|
|
self.assertIn("nodePackages.less", self.src)
|
|
self.assertIn("nodePackages.rtlcss", self.src)
|
|
self.assertNotIn("npm install -g", self.src)
|
|
|
|
def test_the_pager_and_the_less_compiler_are_two_things(self):
|
|
"""« less » le paginateur et « less » le compilateur LESS portent le
|
|
même nom et ne se remplacent pas : les deux sont déclarés."""
|
|
lignes = [x.strip() for x in self.src.splitlines()]
|
|
self.assertIn("less", lignes)
|
|
self.assertIn("nodePackages.less", lignes)
|
|
|
|
def test_postgis_is_a_server_plugin_not_a_package(self):
|
|
"""Déclarée hors du serveur, l'extension ne serait pas chargeable par
|
|
« CREATE EXTENSION »."""
|
|
self.assertIn("extensions = ps:", self.src)
|
|
self.assertIn("postgis", self.src)
|
|
|
|
def test_a_compiler_outside_a_nix_shell_finds_the_headers(self):
|
|
"""Sans ces variables, ce qui n'a pas de roue amont ne se compile pas :
|
|
gcc ne cherche ni en-têtes ni bibliothèques dans le profil système."""
|
|
for var in ("CPATH", "LIBRARY_PATH", "PKG_CONFIG_PATH"):
|
|
with self.subTest(var=var):
|
|
self.assertIn(var, self.src)
|
|
|
|
def test_the_variables_reach_a_non_interactive_ssh(self):
|
|
"""« environment.variables » n'écrit que dans /etc/set-environment,
|
|
que seul un shell de CONNEXION lit. Le déploiement, lui, installe par
|
|
« ssh hôte 'commande' » : la variable y serait vide."""
|
|
self.assertIn("environment.sessionVariables", self.src)
|
|
self.assertNotIn("environment.variables", self.src)
|
|
|
|
def test_the_html_manuals_are_left_out(self):
|
|
"""NixOS installe la sortie « doc » de CHAQUE paquet du système
|
|
(extraOutputsToInstall vaut « man info doc »). Celle de CPython n'est
|
|
pas dans le cache binaire : le premier rebuild la BÂTIT, un Sphinx de
|
|
trois mille pages qui domine le temps d'installation et fait cesser de
|
|
répondre une machine étroite.
|
|
|
|
« documentation.doc » et non « documentation » : les pages de manuel
|
|
et info restent, elles se lisent depuis un terminal."""
|
|
self.assertIn("documentation.doc.enable = false;", self.src)
|
|
self.assertNotIn("documentation.enable", self.src)
|
|
|
|
def test_the_install_reads_the_paths_off_the_filesystem(self):
|
|
"""Une session reçoit les variables du module à son OUVERTURE, par
|
|
pam_env. L'installation applique le module (« make install_os ») puis
|
|
compile (« make install_odoo_18 ») dans la MÊME session : la sienne
|
|
est plus vieille que ce qu'elle vient de déclarer.
|
|
|
|
Les trois paquets du verrou qui n'ont pas de roue amont s'arrêtaient
|
|
alors sur « lber.h », « cups/http.h » et « mysql.h » — au PREMIER
|
|
passage seulement, ce qui est la pire des pannes : le second réussit
|
|
et donne raison à tort. env_var.sh relit donc le profil courant du
|
|
système, un lien sur le disque, plutôt qu'une variable héritée."""
|
|
env = (RACINE / "env_var.sh").read_text(encoding="utf-8")
|
|
self.assertIn("if [ -d /run/current-system/sw ]", env)
|
|
for var in ("CPATH", "LIBRARY_PATH", "PKG_CONFIG_PATH"):
|
|
with self.subTest(var=var):
|
|
self.assertIn(f"export {var}=", env)
|
|
self.assertIn("/run/current-system/sw", env)
|
|
|
|
def test_nothing_is_exported_off_nixos(self):
|
|
"""Le garde est le répertoire lui-même : ailleurs, aucune de ces
|
|
variables n'est touchée."""
|
|
env = (RACINE / "env_var.sh").read_text(encoding="utf-8")
|
|
bloc = env.split("if [ -d /run/current-system/sw ]")[1].split("fi")[0]
|
|
self.assertNotIn("\nexport", bloc.replace("\n export", ""))
|
|
|
|
def test_the_headers_are_linked_into_the_profile(self):
|
|
"""Le profil ne porte pas « /include » par défaut : sans cette ligne,
|
|
déclarer une sortie « .dev » ne met les en-têtes nulle part, et
|
|
« fatal error: lber.h » reste entier."""
|
|
self.assertIn("environment.pathsToLink", self.src)
|
|
self.assertIn('"/include"', self.src)
|
|
|
|
|
|
class LHoteSansGestionnaire(unittest.TestCase):
|
|
"""Ce que le menu répond sur un système où rien ne s'installe.
|
|
|
|
« Aucun gestionnaire connu » est vrai sur NixOS et n'y mène nulle part :
|
|
la phrase seule ferme la porte, alors que deux gestes l'ouvrent — le shell
|
|
jetable pour essayer, la déclaration pour ce qui reste.
|
|
"""
|
|
|
|
def setUp(self):
|
|
from script.todo import todo_install
|
|
|
|
self.ti = todo_install
|
|
self._vrai = todo_install.os_id
|
|
self.addCleanup(setattr, todo_install, "os_id", self._vrai)
|
|
|
|
def test_a_nixos_host_is_told_what_works_instead(self):
|
|
self.ti.os_id = lambda: "nixos"
|
|
conseil = self.ti.conseil_sans_gestionnaire()
|
|
self.assertIn("nix-shell -p", conseil)
|
|
self.assertIn("configuration.nix", conseil)
|
|
|
|
def test_nothing_is_invented_elsewhere(self):
|
|
"""Sur une machine dont on ne sait rien, inventer un conseil vaut
|
|
moins que de se taire."""
|
|
for ident in ("debian", "fedora", "arch", ""):
|
|
with self.subTest(ident=ident):
|
|
self.ti.os_id = lambda ident=ident: ident
|
|
self.assertEqual("", self.ti.conseil_sans_gestionnaire())
|
|
|
|
def test_both_dead_ends_carry_it(self):
|
|
"""Deux endroits impriment « aucun gestionnaire » : celui que tout le
|
|
menu partage, et celui de virt-viewer."""
|
|
for chemin in (
|
|
"script/todo/todo_install.py",
|
|
"script/todo/qemu_access.py",
|
|
):
|
|
with self.subTest(chemin=chemin):
|
|
src = (RACINE / chemin).read_text(encoding="utf-8")
|
|
i = src.index("no known package manager here.")
|
|
self.assertIn("conseil_sans_gestionnaire", src[i : i + 400])
|
|
|
|
|
|
class LeServiceEstDeclare(unittest.TestCase):
|
|
"""Sur NixOS, /etc est généré depuis le store et monté en lecture seule.
|
|
|
|
L'installation dépose l'unité par « tee /etc/systemd/system/
|
|
erplibre.service » sur toute autre distribution ; ici le tee échoue sur
|
|
« Read-only file system », et l'installation entière rend 1 à sa dernière
|
|
étape, après que le dépôt, le venv, les modules compilés et un démarrage
|
|
d'Odoo ont tous réussi. L'unité vient donc de la configuration.
|
|
"""
|
|
|
|
def setUp(self):
|
|
self.src = MODULE.read_text(encoding="utf-8")
|
|
self.script = SCRIPT.read_text(encoding="utf-8")
|
|
|
|
def test_the_unit_is_declared_in_the_module(self):
|
|
self.assertIn("systemd.services.erplibre", self.src)
|
|
self.assertIn('Type = "simple";', self.src)
|
|
self.assertIn('User = "@EL_USER@";', self.src)
|
|
|
|
def test_it_starts_at_boot_without_a_symlink(self):
|
|
"""« systemctl enable » activerait par un lien dans /etc, que le
|
|
système refuse d'écrire. « wantedBy » en est l'équivalent déclaratif,
|
|
et c'est la seule forme d'activation qui tienne ici.
|
|
|
|
L'absence de « systemctl enable » se vérifie sur la COMMANDE du menu,
|
|
plus bas : un module Nix n'exécute rien, et l'y chercher interdirait
|
|
au commentaire de nommer ce qu'il explique."""
|
|
self.assertIn('wantedBy = [ "multi-user.target" ];', self.src)
|
|
|
|
def test_the_interpreter_comes_from_the_store(self):
|
|
"""/bin et /usr/bin sont un montage FUSE d'envfs, et systemd résout
|
|
l'exécutable d'ExecStart lui-même, hors de portée de ce montage :
|
|
« /bin/bash » y rend « 203/EXEC ». Avec Restart=always, l'unité boucle
|
|
indéfiniment."""
|
|
self.assertIn('ExecStart = "${pkgs.bash}/bin/bash', self.src)
|
|
self.assertNotIn('ExecStart = "/bin/bash', self.src)
|
|
self.assertNotIn('ExecStart = "/usr/bin/env', self.src)
|
|
|
|
def test_the_unit_carries_the_path_its_scripts_need(self):
|
|
"""Une unité ne reçoit pas le PATH d'une session. run.sh lance des
|
|
scripts dont le shebang est « env bash » : env est dans le PATH par
|
|
défaut, bash non, et run.sh s'arrête avant Odoo."""
|
|
self.assertIn("path = with pkgs; [ bash python312 ];", self.src)
|
|
|
|
def test_the_repository_is_not_guessed(self):
|
|
"""Le service lance le dépôt QUI A POSÉ le module. Écrire
|
|
« /home/$USER/git/erplibre » se tromperait sur une installation de
|
|
production, qui vit sous /opt."""
|
|
self.assertIn('WorkingDirectory = "@EL_DIR@";', self.src)
|
|
self.assertIn("EL_DIR=${EL_DIR:-${PWD}}", self.script)
|
|
|
|
def test_both_placeholders_are_substituted(self):
|
|
"""Un marqueur non substitué partirait tel quel dans /etc/nixos et
|
|
ferait échouer l'évaluation du module."""
|
|
for marqueur in ("@EL_USER@", "@EL_DIR@"):
|
|
with self.subTest(marqueur=marqueur):
|
|
self.assertIn(marqueur, self.src)
|
|
self.assertIn(marqueur, self.script)
|
|
|
|
|
|
class LeMenuNEcritPasDansEtcSurNixos(unittest.TestCase):
|
|
def _cmd(self, prod=False):
|
|
import sys
|
|
|
|
sys.argv = ["todo.py"]
|
|
sys.path.insert(0, str(RACINE))
|
|
from script.todo.todo import TODO
|
|
|
|
return TODO.__new__(TODO)._qemu_odoo_service_cmd(prod=prod)
|
|
|
|
def test_nixos_is_recognised_before_the_write(self):
|
|
"""Reconnu DANS la VM : la même commande sert au déploiement, au test
|
|
long et à un « --hote » qu'on n'a pas créé."""
|
|
for prod in (False, True):
|
|
with self.subTest(prod=prod):
|
|
cmd = self._cmd(prod)
|
|
self.assertLess(
|
|
cmd.index("ID=nixos"),
|
|
cmd.index("tee /etc/systemd/system"),
|
|
)
|
|
|
|
def test_the_declarative_branch_only_restarts(self):
|
|
"""L'unité existe déjà — le module l'a déclarée. « enable » écrirait
|
|
un lien dans /etc, que le système refuse."""
|
|
cmd = self._cmd()
|
|
nix = cmd[cmd.index("ID=nixos") : cmd.index("tee /etc/systemd/system")]
|
|
self.assertIn("systemctl restart erplibre.service", nix)
|
|
self.assertNotIn("systemctl enable", nix)
|
|
|
|
def test_a_missing_unit_is_named_and_fails(self):
|
|
"""Sans le module, « restart » rendrait une erreur de systemd sans
|
|
dire ce qui manque ni où le prendre."""
|
|
cmd = self._cmd()
|
|
self.assertIn("systemctl cat erplibre.service", cmd)
|
|
self.assertIn("make install_os", cmd)
|
|
|
|
|
|
class LeServiceAttendQuOdooSoitLa(unittest.TestCase):
|
|
"""L'unité est déclarée par le module, donc démarrée par la
|
|
reconstruction — laquelle a lieu PENDANT « make install_os ».
|
|
|
|
La source d'Odoo, elle, n'arrive qu'à « make install_odoo_18 ». Entre les
|
|
deux, run.sh échoue sur un odoo-bin absent et « Restart = always » le
|
|
rejoue toutes les cinq secondes : vingt et un échecs mesurés sur une pose
|
|
ordinaire, et un « nixos-rebuild » qui rend 4 au lieu de 0 parce qu'une
|
|
unité n'a pas démarré. Le journal d'une machine neuve s'ouvre alors sur
|
|
une avalanche qui n'accuse rien de réel.
|
|
|
|
Une CONDITION plutôt qu'une dépendance : mesuré sur une VM, systemd saute
|
|
l'unité en le disant une fois — « was skipped because of an unmet
|
|
condition check » — sans la marquer en échec, puis la démarre d'elle-même
|
|
une fois le fichier là.
|
|
"""
|
|
|
|
def setUp(self):
|
|
self.src = MODULE.read_text(encoding="utf-8")
|
|
|
|
def test_the_unit_waits_for_what_run_sh_executes(self):
|
|
self.assertIn(
|
|
'unitConfig.ConditionPathExistsGlob = "@EL_DIR@/odoo*/odoo/'
|
|
'odoo-bin";',
|
|
self.src,
|
|
)
|
|
|
|
def test_the_odoo_version_is_not_frozen_in_the_module(self):
|
|
"""Une version écrite ici vieillirait en silence : l'unité cesserait
|
|
de démarrer le jour où le dépôt passe à la suivante."""
|
|
condition = [l for l in self.src.splitlines() if "ConditionPath" in l]
|
|
self.assertEqual(len(condition), 1)
|
|
self.assertNotIn("odoo18", condition[0])
|
|
|
|
def test_it_is_a_condition_and_not_a_dependency(self):
|
|
"""« requires » sur un chemin n'existe pas, et « after » ne
|
|
garantirait rien : seule une condition SAUTE au lieu d'échouer."""
|
|
self.assertNotIn('odoo-bin" ]', self.src)
|
|
self.assertIn("ConditionPathExistsGlob", self.src)
|
|
|
|
def test_the_marker_is_substituted_everywhere(self):
|
|
"""Le chemin du dépôt apparaît désormais deux fois dans le module ;
|
|
un sed sans « g » n'en remplacerait qu'une, et la condition porterait
|
|
un « @EL_DIR@ » littéral que rien ne satisfait jamais."""
|
|
script = SCRIPT.read_text(encoding="utf-8")
|
|
self.assertIn("s#@EL_DIR@#${EL_DIR}#g", script)
|
|
self.assertGreater(self.src.count("@EL_DIR@"), 1)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|