44 lines
2.2 KiB
Markdown
44 lines
2.2 KiB
Markdown
|
# 📦 Dossier de transmission — Alliance Boréale
|
|||
|
|
|
|||
|
|
> Ce document permet à une nouvelle équipe de **reprendre** et **ré-instancier** un écosystème Alliance Boréale à partir du dépôt “constitution”.
|
|||
|
|
|
|||
|
|
## 1) Résumé exécutif
|
|||
|
|
- **Ce que c’est** : un cadre (constitution + standards + SSOT) pour bâtir un écosystème numérique **autonome, interopérable et reproductible**.
|
|||
|
|
- **Où est la vérité** : un **YAML unique** (`configure/configure.yaml`) — toutes les configurations dérivent de ce fichier.
|
|||
|
|
- **Ce que fait la forge** : héberge la constitution et **miroire** les prérequis non-Debian (sources externes).
|
|||
|
|
- **Ce que fournit ce dépôt** :
|
|||
|
|
- gouvernance (constitution),
|
|||
|
|
- règles techniques (DNS/PKI, IP v3, couches),
|
|||
|
|
- SSOT + exports (Prometheus, Icinga, DNS, Ansible, NetBox),
|
|||
|
|
- CI de base (lint YAML, build docs).
|
|||
|
|
|
|||
|
|
## 2) Principes structurants
|
|||
|
|
- **Couches** : 1–4 (infra/réseau/systèmes/sécurité) ↔ **VPN** ; 5–8 (services/app/UI) ↔ **PKI/TLS** (pas besoin de VPN).
|
|||
|
|
- **Adressage** : 10/8 local par fédéré ; 172.16/12 fédératif ; 172.20/16 P2P.
|
|||
|
|
- **Nommage** : `<service>.<couche>.<tenant|site>.<domaine>`.
|
|||
|
|
- **VNI** : `VNI = tenant_id × 10000 + VLAN` (auto-calcul si `vni` vide).
|
|||
|
|
|
|||
|
|
## 3) Arborescence (vue d’ensemble)
|
|||
|
|
- `docs/` : site MkDocs + **Constitution** (vision, gouvernance, standards)
|
|||
|
|
- `specs/` : charte DNS/PKI, plan d’adressage IP v3
|
|||
|
|
- `configure/` : **SSOT** (`configure.yaml`) + export CLI (`export.mjs`)
|
|||
|
|
- `dns/` : zones & politiques
|
|||
|
|
- `ansible/` : inventaire/rôles (seed)
|
|||
|
|
- `terraform/` : IaC commun
|
|||
|
|
- `.forgejo/` : CI (YAML lint, build docs)
|
|||
|
|
|
|||
|
|
## 4) Processus de changement (PR-first)
|
|||
|
|
- Toute évolution **passe par PR** sur `main` (branche protégée).
|
|||
|
|
- **CODEOWNERS** exigent au moins 1 approbation.
|
|||
|
|
- CI doit passer (lint + exports + build docs).
|
|||
|
|
- Tag de version “constitution” : `vYYYY.M` (ex: `v2025.1`) après ratification.
|
|||
|
|
|
|||
|
|
## 5) Démarrage rapide (voir aussi INSTALL.md)
|
|||
|
|
```bash
|
|||
|
|
git clone <forge>/<owner>/alliance-boreale.git
|
|||
|
|
cd alliance-boreale
|
|||
|
|
$EDITOR configure/configure.yaml # renseigner les valeurs (site, tenant, IP…)
|
|||
|
|
cd configure && npm ci || npm i
|
|||
|
|
node export.mjs # génère out/{prometheus,icinga,dns,ansible,netbox}
|
|||
|
|
|