Daniel Allaire
aab1bcc83a
README reduit au role du projet et au demarrage rapide. docs/architecture.md (schemas Mermaid), docs/setup.md, docs/usage.md (154 cibles en 13 familles), docs/README.md (index). Documents ranges en conception/, exploitation/, hebergement/, projet/ ; 598 chemins suivis. QUICKSTART.md, SOLUTION.md, architecture-set-ops.md et la carte fondus puis retires. Preuves : P48 lit l'index et conception/mecanismes.md ; les gardes parcourent docs/ sous- dossiers compris (_documents) ; usage.md suit le Makefile dans les deux sens. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.7 KiB
La méta-classe — une définition, tout l'écosystème
Pour qui : le mainteneur — le concept qui explique pourquoi on écrit un plan et non onze serveurs.
Set-OPS se comporte comme une méta-classe : on n'écrit pas onze serveurs, on écrit une définition d'écosystème (le plan déclaratif) ; l'instanciation engendre la flotte entière, cohérente. Le réseau, la taille des VM, les groupes, les liens de bases (DSN) et l'exposition DNS sont dérivés — jamais saisis deux fois.
Concept acté dans
positionnement.md: « la définition instancie toute la flotte ». La dérivation des ressources est décrite dansdimensionnement-ressources.md.
Schéma
flowchart TB
subgraph DEF["① DÉFINITION — la méta-classe (le plan déclaratif)"]
direction LR
NOM["nomenclature.yml<br/>catégories · VLAN · fonctions"]
SRV["serveurs.yml<br/>VM = fonction + état + overrides"]
APP["applications.yml<br/>app → rôle · hôte · expose"]
BD["bases-donnees.yml<br/>serveurs_bd · DSN · portée"]
DOM["domaines.yml<br/>domaines publics · edge"]
EMP["roles/*/meta/empreinte.yml<br/>empreinte ressources"]
TPL[("golden template<br/>Debian 13 durci")]
end
subgraph GEN["② DÉRIVATION — make instancier (le constructeur)"]
direction LR
R1["réseau<br/>VMID · VLAN · IP · gw"]
R2["ressources<br/>cœurs · RAM · disque"]
R3["groupes<br/>socle + services + état"]
R4["liens<br/>DSN + exposition DNS"]
end
subgraph INST["③ INSTANCES — la flotte (inventory hosts.yml)"]
direction LR
INV[["hosts.yml"]]
VMS(("14 VM<br/>infra-pki · infra-dns · infra-mail · infra-edge · edge-mta<br/>idm · data-sql · obs · mon · forge · collab<br/>web-frontal · web-dorsal · ops"))
end
ECO["④ ÉCOSYSTÈME souverain en service<br/>PKI · DNS · IdM/SSO · Données · Observabilité · Forge · Web"]
DEF --> GEN --> INST
TPL -. "clone + cloud-init" .-> VMS
INV --> VMS
INST -- "make deployer · rôles par groupe" --> ECO
Le même schéma en texte
① DÉFINITION — la « méta-classe » (instance/plan/ + roles/*/meta/empreinte.yml)
nomenclature · serveurs · applications · bases-données · domaines
⟦ golden template Debian 13 durci ⟧
│ make instancier
▼
② DÉRIVATION — le constructeur (instancier.py · inventory_rules · filter_plugins)
réseau (VMID·VLAN·IP·gw) · ressources (cœurs·RAM·disque) · groupes · DSN+DNS
│ = instanciation
▼
③ INSTANCES — la flotte (inventory hosts.yml : 14 VM cohérentes)
infra-pki · infra-dns · infra-mail · infra-edge · edge-mta · idm · data-sql
obs · mon · forge · collab · web-frontal · web-dorsal · ops
▲ clone du golden template + identité cloud-init
│ make deployer (rôles Ansible par groupe)
▼
④ ÉCOSYSTÈME souverain en service
PKI · DNS interne · IdM+SSO · Bases · Observabilité · Forge · Web
1 définition ───────────────▶ N VM : réseau, taille, groupes, DSN, DNS
(édite le plan) tout dérivé, rien saisi deux fois.
Pourquoi c'est une méta-classe
Une classe ordinaire instancie un objet. Ici, une définition instancie un ensemble cohérent d'objets (VM + services + liens), avec leurs invariants garantis par dérivation plutôt que par discipline humaine. Éditer le plan, c'est faire évoluer la classe ; régénérer, c'est ré-instancier — de façon idempotente.