Daniel Allaire
4624f86bec
La documentation est organisee par SUJET, ce qui est juste pour de la reference. Mais personne n'arrive avec un sujet : on arrive avec une SITUATION. Il y en a quatre, trois avaient deja une porte, celle de l'exploitant qui herite n'en avait aucune. La page ne contient presque rien en propre : un ORDRE et des renvois, en cinq temps. Dans quel etat tu herites (les six devis avant tout geste) ; entrer (la cle de voute, l'amorcage, la racine qui mene a la mauvaise console, l'AC dans le navigateur) ; de quoi c'est fait (a demander au plan, pas a lire) ; quand ca casse ; et ce qui va te mentir. Elle declare son lecteur en premiere ligne — la convention qui empeche la rechute : un runbook de reprise enterre dans autorisation.md parce que le SUJET est l'autorisation, personne ne va l'y chercher. Home.md et _Sidebar.md l'annoncent, et disent desormais la regle du miroir : une page editee dans l'interface de la forge est DETRUITE a la publication suivante (wiki-publier fait un delete puis recopie). On lit dans le wiki, on ecrit dans le depot. Chaque cible make et chaque renvoi verifies un a un : `make ca-installer` n'existait pas, c'est `ca-racine` + `ca-empreinte`. Le plan de recette (P22) ne bouge pas : la page n'est pas une unite d'apprentissage. La page « Ce qui va te mentir » est annoncee sans lien tant qu'elle n'existe pas — une porte qui pointe dans le vide est pire que pas de porte. Verifie : prouver.py 0 (33 OK), plan-recette inchange. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
50 lines
3.2 KiB
Markdown
50 lines
3.2 KiB
Markdown
# Set-OPS — moteur souverain **et** compagnon pédagogique
|
|
|
|
Bienvenue. **Set-OPS** est le moteur Ansible qui déploie un **écosystème numérique souverain
|
|
complet** (Alliance Boréale · *tout est libre*). Mais c'est aussi, et volontairement, un **outil
|
|
pédagogique** : il instancie *pour de vrai* la quasi-totalité des **fondamentaux des TIC**, avec
|
|
des **méthodes 100 % génériques**.
|
|
|
|
## Deux usages, un seul système
|
|
- **Exploiter** : monter et opérer un écosystème réel (PKI, identité, courriel, DNS, observabilité,
|
|
supervision, sauvegardes…).
|
|
- **Apprendre** : chaque service est une **lentille sur un fondamental**. Tu n'apprends pas
|
|
« Keycloak » — tu apprends le **SSO/OIDC**. Pas « step-ca » — la **PKI**. Ces savoirs se
|
|
**transfèrent partout** (Active Directory, Okta, Vault, n'importe quel DNS…).
|
|
|
|
> **Tu ne découvres pas — tu viens d'hériter d'un écosystème déjà déployé ?**
|
|
> Commence par **[Reprendre l'écosystème](Reprendre-l-écosystème)** : dans quel état tu
|
|
> hérites, comment entrer, et ce qui va te mentir en chemin.
|
|
|
|
> **Ce wiki est publié depuis le dépôt** (`wiki/`). Une page modifiée dans l'interface de la
|
|
> forge est **détruite** à la publication suivante : on lit ici, on écrit dans le dépôt.
|
|
|
|
## Comment ce wiki est organisé
|
|
| Section | Contenu |
|
|
|---|---|
|
|
| **Unités d'apprentissage** | Un fondamental TIC par page, toujours selon le même moule (ci-dessous). Des *services* (identité, PKI, courriel…) **et** de la *méthode* (le plan, le multi-instance, la preuve). |
|
|
| **Opérations (runbooks)** | Procédures : ajouter un service, déployer un nœud, restaurer une sauvegarde… |
|
|
| **[Glossaire](Glossaire)** | Les concepts-clés en une phrase (seed, bindings, le plancher, hôte fantôme, voûte…). |
|
|
| **Référence technique** | Le *détail du « comment »* vit **dans le dépôt** (`docs/`, README des rôles) — ce wiki y **pointe**, ne le **recopie pas** (pour éviter la dérive). |
|
|
|
|
## Le moule d'une unité d'apprentissage
|
|
Chaque unité suit **quatre temps** :
|
|
|
|
> **1. Le concept** *(générique, indépendant de tout produit)*
|
|
> **2. Comment Set-OPS le fait** *(le vrai, observable dans le lab)*
|
|
> **3. Pourquoi c'est transférable** *(les équivalents ailleurs)*
|
|
> **4. À toi de jouer** *(observe · interroge · casse · répare)*
|
|
|
|
## Par où commencer
|
|
- 🔑 **[Reprendre l'écosystème](Reprendre-l-écosystème)** — si tu dois l'**exploiter** dès
|
|
aujourd'hui : l'ordre des opérations, pas la théorie.
|
|
- 👉 **[Identité & SSO](Identité-et-SSO)** — l'unité-pilote côté *services* (SSO, annuaire, OIDC).
|
|
- 🧭 **[Le plan & l'adressage dérivé](Le-plan-et-l-adressage-dérivé)** — l'unité-pilote côté
|
|
*méthode* : un seed, tout en découle. C'est la clé de voûte du reste.
|
|
- 🌐 **[Multi-instance & fédération](Multi-instance-et-fédération)** — un moteur, N écosystèmes.
|
|
- 🔬 **[La preuve](La-preuve)** — *ne jamais affirmer plus que ce qu'on prouve.*
|
|
|
|
---
|
|
*Deux axes sont enseignés partout : le **QUOI** (les concepts) et le **COMMENT** (les méthodes de
|
|
métier : déclaratif, idempotent, vérifier-avant-déployer, restaurer-pour-prouver, durcir). C'est la
|
|
culture d'un artisan du numérique souverain.*
|