Set-OPS-Public/README.md
Daniel Allaire aab1bcc83a doc : rangee par lecteur, trois portes d'entree (architecture, setup, usage) et un index
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>
2026-10-15 01:01:54 -04:00

60 lines
2.6 KiB
Markdown

# Set-OPS — moteur d'écosystèmes numériques souverains
Set-OPS construit et exploite un **écosystème numérique souverain** sur une grappe
**Proxmox**, à partir d'un **plan déclaratif** : DNS, AC interne, identité (LDAP + SSO),
courriel, bases de données, observabilité, forge, applications web. Logiciel libre
exclusivement ; ni Docker, ni Podman.
- **Moteur** (ce dépôt) : rôles Ansible, playbooks, scripts de dérivation, preuves.
- **Écosystème** : un dépôt par locataire (`OPS-<nom>`) — son plan, son inventaire
généré, sa voûte. Un dépôt par site d'hébergement (`SITE-<nom>`) — son underlay, sa
frontière.
- **Plan → inventaire → déploiement** : on édite le plan, le moteur génère l'inventaire et
l'ordre de déploiement, Ansible applique. L'inventaire ne s'édite jamais à la main.
- **Sans IA** : la doc, `make` et le GUI suffisent à l'exploiter.
## Démarrage rapide
Prérequis : une grappe Proxmox et un jeton d'API, un poste Linux avec Python 3, Ansible,
`make` et `git`, une paire de clés SSH.
```bash
git clone <url-de-Set-OPS> Set-OPS && cd Set-OPS
# 1. Un écosystème, depuis le modèle public, et la clé de sa voûte
make instance-creer NOM=OPS-MonOrg MODELE=socle
ln -s ../OPS-MonOrg instance
install -m 600 /dev/null ~/.config/setops-vault-ops-monorg # la phrase de passe, une ligne
# renseigner domaine_interne, nomenclature, domaines, placement : docs/setup.md §3
# 2. Proxmox et le gabarit Debian 13 (une fois par grappe)
make config
make preparer-modele && make verifier-modele && make nettoyer-modele CONFIRMER=true
# 3. Inventaire, VM, déploiement
make instancier && make instancier-appliquer FORCE=1
make creer-vm HOTE=infra-dns-01
make deployer HOTE=infra-dns-01
# 4. Vérifier
make verifier
```
Chaque étape, ses fichiers et ses pièges : [`docs/setup.md`](docs/setup.md).
## Documentation
| Document | Contenu |
|---|---|
| [`docs/README.md`](docs/README.md) | l'index : par situation, par lecteur |
| [`docs/architecture.md`](docs/architecture.md) | composants, flux de données, réseau, sécurité |
| [`docs/setup.md`](docs/setup.md) | installation et configuration |
| [`docs/usage.md`](docs/usage.md) | conventions, variables, toutes les commandes |
| [`wiki/Home.md`](wiki/Home.md) | le métier, pas à pas |
| [`AGENTS.md`](AGENTS.md) | les règles d'autorité du dépôt |
## Licence
Copyright (C) 2026 Daniel Allaire — Chezlepro / Alliance Boréale. Logiciel libre sous
**GNU Affero General Public License v3** ou ultérieure : voir [`LICENSE`](LICENSE). Pourquoi
l'AGPLv3, et le modèle libre + services : [`docs/projet/positionnement.md`](docs/projet/positionnement.md) §6.