Set-OPS-Public/roles/serveur_ops
Daniel Allaire 5d0f82792a portabilite : declarer ce dont le moteur depend — quatre defauts reveles par le runner
Premiere materialisation d'une VM de tenant depuis le runner du SITE. Elle a
echoue quatre fois d'affilee, sur quatre dependances que le moteur ne declarait
nulle part. Chacune fonctionnait chez le mainteneur pour une raison DIFFERENTE,
et aucune de ces raisons n'existe sur une autre machine.

1. VERSIONS DES COLLECTIONS. `requirements.yml` les nommait sans les epingler. Le
   runner a recu `community.general` 13.3.0 quand le poste porte la 10.3.0 — et la
   11 a retire les modules Proxmox de cette collection.
       ERROR! couldn't resolve module/action 'community.general.proxmox_pool'

2. INSTALLATION EN AVANT. `ansible-galaxy` ne retrograde pas : declarer la 10.3.0
   ne suffisait pas a defaire une 13.3.0 deja posee. `--force`.

3. EMPLACEMENT. Le `Makefile` pose `ANSIBLE_HOME ?= $(CURDIR)/.ansible` : sous
   `make`, Ansible ne lit QUE `<moteur>/.ansible/collections`. Le role deposait
   dans `<racine>/.ansible/collections` — a cote, jamais lu. Invisible chez le
   mainteneur, ou les collections viennent du paquet systeme, toujours dans le
   chemin quel que soit ANSIBLE_HOME. Et le garde-fou d'installation suivait le
   DEPOT des archives : changer la destination ne le declenchait pas. Il mesure
   desormais la destination — meme piege qu'en 2026-08-24, deplace d'un cran.

4. BIBLIOTHEQUES PYTHON. Le venv recevait `ansible-core` et `pyyaml`, ecrits en
   dur. Les modules Proxmox tournent `delegate_to: localhost` et exigent
   `proxmoxer` SUR LE CONTROLEUR.
       La bibliotheque Python proxmoxer est absente

   Ne d'ici : `requirements-python.txt`, avec sa frontiere ecrite — il ne declare
   QUE ce qui tourne sur le controleur. `python-ldap` et `psycopg2` s'executent
   sur leurs cibles ; le poste du mainteneur ne les a pas et la flotte se deploie,
   ce qui prouve que la ligne est au bon endroit.

P51 garde les trois faiblesses de cette famille : une dependance utilisee sans
etre declaree (le defaut du 2026-08-24, `ansible.posix`), une dependance declaree
sans version, et `proxmoxer` absent alors que des playbooks Proxmox existent.
Quatre controles negatifs verifies.

RESULTAT : ops-01 materialisee par le runner du site. L'agent invite rapporte
`eth0 10.17.19.41/24`, Debian 13 trixie — l'adressage derive du plan, applique.

Un seul executant masque ces ecarts indefiniment ; un second les revele tous en
une soiree. Meme mecanique que le second tenant en aout.

make prouver : CONFORME, 51 OK, 0 echec.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-27 22:38:35 -04:00
..
defaults forge du genome : mutualisee par site, avec une confiance limitee a une url 2026-08-24 18:55:44 -04:00
meta forge du genome : mutualisee par site, avec une confiance limitee a une url 2026-08-24 18:55:44 -04:00
tasks portabilite : declarer ce dont le moteur depend — quatre defauts reveles par le runner 2026-08-27 22:38:35 -04:00
templates serveur_ops : la difference entre une archive et une matrice 2026-08-23 11:58:10 -04:00
README.md serveur_ops : la difference entre une archive et une matrice 2026-08-23 11:58:10 -04:00

serveur_ops

Poste d'exploitation : la machine depuis laquelle l'écosystème se reconstruit lui-même. Ansible épinglé, le génome cloné depuis sa propre forge, et une clé SSH qui n'appartient qu'à lui.

Principe

Un écosystème pouvait jusqu'ici détenir son génome sans savoir l'exécuter. Les cinq dépôts vivaient sur sa forge — moteur, plans, modèles, étiquette signée — mais Set-OPS ne tournait que depuis le poste de son mainteneur. L'écosystème possédait le livre ; personne, chez lui, ne savait le lire à voix haute.

serveur_ops est la différence entre une archive et une matrice.

Ce que le poste emporte

/opt/setops/
  Set-OPS-public/     le moteur          ← cloné depuis genome/set-ops-public
  OPS-<instance>/     le plan            ← cloné depuis genome/ops-<instance>
  venv/               ansible-core 2.18  (épinglé)
  .ssh/id_ed25519     la clé du poste
  LISEZ-MOI.md        mode d'emploi, généré

Le moteur et les instances sont des dossiers frères, comme sur le poste du mainteneur : c'est cette fraternité que scripts/instances.py découvre pour proposer les instances pilotables. Le lien instance désigne celle qu'on pilote.

D'où vient le génome : de sa propre forge

Le poste clone depuis https://forge.<domaine>/genome/…, pas depuis la forge parente. Les dépôts y sont des miroirs, resynchronisés toutes les huit heures : la copie est vivante, et l'écosystème se reconstruit depuis lui-même.

Le clone est anonyme — les dépôts du génome sont lisibles sur la forge interne. Un secret de moins sur une machine qui en concentre déjà beaucoup.

La confiance TLS vient de client_pki (racine step-ca dans le magasin système). Sans elle, git clone refuse le certificat de la forge, et il a raison de refuser.

Les deux choses qu'il n'a PAS

Le mot de passe de la voûte. Il se saisit à l'exécution. Une machine qui détiendrait à la fois le plan, l'accès SSH à toute la flotte et la clé des secrets n'aurait plus aucune profondeur : la compromettre serait compromettre l'écosystème entier.

Le fichier de voûte lui-même. Les dépôts d'instance excluent vault.yml de git — c'est la règle « aucun secret en clair ». Le génome cloné ici porte donc le plan sans les secrets.

Conséquence à connaître, et qui n'est pas un défaut mais une conception :

la STRUCTURE de l'écosystème se reconstruit depuis la forge
les SECRETS se restaurent depuis la sauvegarde (restic)

Deux sources distinctes, qu'un même incident n'atteint pas ensemble.

Sa clé doit être autorisée

Le poste fabrique sa propre paire, distincte de celle du mainteneur : deux exploitants, deux révocations possibles, et l'accès du poste se lit dans les authorized_keys de la flotte au lieu de se confondre avec celui d'un humain.

Tant que cette clé publique n'est pas portée aux intrants SSH du plan, le poste ne joint aucun hôte. Le rôle l'affiche au déploiement ; elle se relit à tout moment :

cat /opt/setops/.ssh/id_ed25519.pub

C'est volontairement un geste humain : donner à une machine le droit d'entrer partout mérite une décision, pas un effet de bord.

Variables principales

Variable Défaut Rôle
serveur_ops_utilisateur setops compte d'exploitation
serveur_ops_racine /opt/setops racine du poste
serveur_ops_ansible ansible-core>=2.18,<2.19 version épinglée
serveur_ops_forge_url https://forge.<domaine> source du génome
serveur_ops_depots moteur + instance quoi cloner, et où
serveur_ops_instance l'instance du plan cible du lien instance
serveur_ops_cle_generer true fabriquer la clé du poste

Dépendances

serveur_forgejo (la source du génome) — déclaré dans docs/dependances-groupes.yml, avec sauf_si serveur_ops_forge_externe pour l'écosystème qui lit son génome ailleurs. serveur_step_ca est utilisé si présent : sans confiance PKI, le clone échoue sur le certificat.

Ce que ce rôle ne fait pas

Il n'ouvre aucun service, n'écoute sur aucun port, ne publie rien à l'edge. Il ne sauvegarde rien non plus : tout ce qu'il contient se recompose depuis la forge.