Alliance-Boreale/alliance-boreale
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

normes et nomenclature mnémotechnique
Some checks failed
CI / yaml-lint (push) Has been cancelled
Details
CI / ssot-export (push) Has been cancelled
Details
CI / tests (push) Has been cancelled
Details
CI / docs (push) Has been cancelled
Details

Browse source
This commit is contained in:
Dan Allaire 2025-10-21 11:09:16 -04:00
parent d3756d96e9
commit e704e1cc39
8 changed files with 6246 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

310
docs/architecture/checklist_reunion.md Normal file
View file

@ -0,0 +1,310 @@
# CHECKLIST RÉUNION DE VALIDATION
## Standard de Nomenclature v2.0
### L'Alliance Boréale
**Réunion prévue le :** [À définir - Semaine du 11 novembre 2025]
**Durée estimée :** 2h30 (avec pause)
**Lieu :** Visioconférence Matrix + partage d'écran
**Participants requis :** Tous les membres du Cercle Technique
---
## 📋 PRÉPARATION (1-2 semaines avant)
### Documents à Distribuer
- [ ] **Standard de Nomenclature v2.0** (PDF + Markdown)
- Envoyé par email + lien forge
- Date limite de lecture : 7 jours avant réunion
- [ ] **Résolution d'Adoption** (cette résolution)
- Format : PDF signable
- À lire AVANT la réunion
- [ ] **Guide de Formation** (optionnel, pour référence)
- Lien vers la documentation
- [ ] **Scripts et Templates** (accès forge)
- Dépôt Git accessible à tous
- Instructions d'installation test
### Préparation Individuelle des Participants
**Chaque participant DOIT avant la réunion :**
- [ ] **Lire** le Standard complet (60 pages, ~2h)
- Prendre des notes
- Identifier questions/objections
- [ ] **Tester** les scripts sur un environnement de test
- Installer les scripts
- Lancer audit-nomenclature.sh
- Tester validation VMID
- [ ] **Évaluer** l'impact sur son infrastructure
- Estimer nombre de VMs à migrer
- Identifier les cas complexes
- Calculer la charge de travail
- [ ] **Préparer** ses questions/objections
- Format écrit préférable
- Soumission avant réunion (optionnel)
### Préparation du Facilitateur
- [ ] **Réserver** salle visio Matrix avec enregistrement
- [ ] **Préparer** la présentation (voir section suivante)
- [ ] **Compiler** les questions soumises à l'avance
- [ ] **Tester** le partage d'écran et démo live
- [ ] **Préparer** le template de procès-verbal
- [ ] **Imprimer** la résolution (si signatures physiques)
### Préparation Technique
- [ ] **Environnement de démo** opérationnel
- Proxmox de test accessible
- Scripts installés et fonctionnels
- Exemples de VMs conformes/non-conformes
- [ ] **Documents accessibles** pendant la réunion
- Standard (PDF + lien web)
- Résolution (version modifiable)
- Aide-mémoire (imprimable)
- [ ] **Outils collaboratifs** prêts
- Pad collaboratif (HedgeDoc/Etherpad)
- Partage d'écran
- Sondage pour vote de consentement
---
## 🎯 ORDRE DU JOUR DÉTAILLÉ
### INTRODUCTION (10 minutes)
- [ ] **Accueil** et vérification présences
- Tour de table rapide
- Vérifier quorum (tous les membres requis)
- [ ] **Rappel du contexte** (5 min)
- Pourquoi ce standard ?
- Historique du projet (août-octobre 2025)
- Objectifs de la réunion
- [ ] **Présentation de l'ordre du jour** (2 min)
- Timing détaillé
- Pause prévue
- Processus de décision (consentement)
- [ ] **Règles de la réunion** (3 min)
- Parler à tour de rôle (lever la main)
- Questions après chaque section
- Objections exprimées clairement
- Enregistrement (consentement oral)
---
### PARTIE 1 : PRÉSENTATION DU STANDARD (30 minutes)
#### A) Vue d'Ensemble (10 min)
- [ ] **Les 4 piliers** du standard
- VMID mnémotechnique
- Plan d'adressage IP
- Nomenclature VMs
- Nomenclature DNS
- [ ] **Architecture de référence**
- Espace 10.0.0.0/8 derrière NAT
- Infrastructure vs Tenants
- Couches 1-4 vs 5-8
- [ ] **Cohérence totale**
- VMID ↔ IP ↔ Nom ↔ DNS
- Démonstration visuelle
**Questions/Réponses** (5 min)
#### B) Spécifications Techniques (15 min)
- [ ] **Format VMID détaillé**
- Infrastructure : 0CTTII
- Tenant : TTTII
- Exemples concrets
- Validation avec validate-vmid.sh (DÉMO)
- [ ] **Plan d'adressage IP**
- Segmentation infrastructure (10.0.0-2.x)
- Allocation tenants (10.0.10.x + expansion)
- Cohérence avec VMID
- [ ] **Nomenclature complète**
- Noms VMs (infra et tenants)
- DNS interne/fédéré
- Tables de correspondance
**Questions/Réponses** (10 min)
#### C) Outillage (5 min)
- [ ] **6 scripts fournis**
- audit-nomenclature.sh (DÉMO rapide)
- migrate-vm.sh (montrer le workflow)
- Autres scripts (présentation rapide)
- [ ] **Templates Ansible/Terraform**
- Structure des modules
- Exemples d'utilisation
**Questions/Réponses** (5 min)
---
### PAUSE (10 minutes) ☕
---
### PARTIE 2 : IMPACTS ET MISE EN ŒUVRE (25 minutes)
#### A) Impact sur Chaque Membre (15 min)
**Tour de table - chaque membre présente :**
- [ ] **Chezlepro** (5 min)
- Nombre de VMs à migrer
- Cas complexes identifiés
- Charge de travail estimée
- Questions spécifiques
- [ ] **Nuage Libre** (5 min)
- Idem
- [ ] **TechnoLibre** (5 min)
- Idem
#### B) Plan de Migration (10 min)
- [ ] **Timeline proposée**
- Formation : 1er décembre 2025
- Nouveaux déploiements : 1er janvier 2026
- Migration complète : 31 décembre 2026
- [ ] **Ressources allouées**
- Formation (30h Banque de Temps)
- Support technique (20h)
- Budget (0 $ si possible)
- [ ] **Métriques de succès**
- Taux de conformité cible
- Indicateurs de suivi
**Questions/Réponses** (10 min)
---
### PARTIE 3 : DISCUSSION ET OBJECTIONS (30 minutes)
#### A) Questions Générales (10 min)
- [ ] **Clarifications techniques**
- Répondre aux questions restantes
- Démonstrations supplémentaires si nécessaire
- [ ] **Concerns opérationnels**
- Faisabilité
- Charge de travail
- Ressources
#### B) Identification des Objections (20 min)
**Process sociocratique :**
- [ ] **Tour de table** : Chaque membre exprime ses objections
- "Qu'est-ce qui rendrait l'adoption de ce standard **nuisible** ?"
- Prendre note de TOUTES les objections
- [ ] **Catégorisation** des objections
- Bloquantes (rendent l'adoption nuisible)
- Non-bloquantes (améliorations souhaitables)
- [ ] **Traitement des objections bloquantes**
- Discussion pour chaque objection
- Recherche de solutions
- Modification du standard si nécessaire
- Ré-évaluation après modification
---
### PARTIE 4 : DÉCISION PAR CONSENTEMENT (20 minutes)
#### A) Reformulation Finale (5 min)
- [ ] **Récapitulatif** des modifications apportées
- [ ] **Version finale** du standard à adopter
- [ ] **Lecture de la résolution** d'adoption
#### B) Tour de Consentement (10 min)
**Pour chaque membre, poser la question :**
> "As-tu une objection raisonnable et argumentée qui rendrait l'adoption de ce standard **nuisible** pour L'Alliance ou pour ton organisation ?"
- [ ] **Chezlepro** : Consentement ? ☐ Oui ☐ Objection
- Si objection : __________________________________________
- [ ] **Nuage Libre** : Consentement ? ☐ Oui ☐ Objection
- Si objection : __________________________________________
- [ ] **TechnoLibre** : Consentement ? ☐ Oui ☐ Objection
- Si objection : __________________________________________
#### C) Formalisation (5 min)
**Si consentement de tous :**
- [ ] **Déclaration officielle** : "Le Standard de Nomenclature v2.0 est adopté"
- [ ] **Date d'adoption** : _________________________
- [ ] **Signatures** (électroniques ou physiques)
- [ ] **Annonce** : Publication sur Matrix/Forum
**Si objection bloquante non résolue :**
- [ ] Reporter la décision
- [ ] Planifier séance de travail supplémentaire
- [ ] Nouvelle réunion de validation (date : _________)
---
### PARTIE 5 : PROCHAINES ÉTAPES (10 minutes)
**Si adoption réussie :**
- [ ] **Publication officielle**
- Forge Git (tag v2.0)
- Wiki Alliance Boréale
- Annonce Matrix/Forum
- [ ] **Désignation responsabilités**
- Gardien du standard : __________________________
- Responsable formation : __________________________
- Support technique : __________________________
- [ ] **Planification formation**
- Dates des sessions
- Inscription des administrateurs
- [ ] **Premiers audits**
- Chaque membre lance audit initial
- Date limite : __________________________
- [ ] **Suivi**
- Réunion de suivi 1 mois après (décembre 2025)
- Rapport mensuel de conformité
---
### CLÔTURE (5 minutes)
- [ ] **Récapitulatif** de la décision
- [ ] **Remerciements** aux participants
- [ ] **Prochaine

979
docs/architecture/guide_formation.md Normal file
View file

@ -0,0 +1,979 @@
# Guide de Formation - Nomenclature v2.0
## L'Alliance Boréale
**Version :** 1.0
**Date :** 21 octobre 2025
**Durée :** 2-3 heures (formation complète)
**Public :** Administrateurs systèmes membres de L'Alliance
**Prérequis :** Connaissance Proxmox, bases Linux
---
## Table des Matières
1. [Introduction et Contexte](#1-introduction-et-contexte)
2. [Module 1 : Comprendre le Standard](#2-module-1-comprendre-le-standard)
3. [Module 2 : VMID Mnémotechnique](#3-module-2-vmid-mnémotechnique)
4. [Module 3 : Plan d'Adressage IP](#4-module-3-plan-dadressage-ip)
5. [Module 4 : Nomenclature VMs et DNS](#5-module-4-nomenclature-vms-et-dns)
6. [Module 5 : Outils Pratiques](#6-module-5-outils-pratiques)
7. [Module 6 : Migration en Pratique](#7-module-6-migration-en-pratique)
8. [Exercices Pratiques](#8-exercices-pratiques)
9. [Aide-Mémoire](#9-aide-mémoire)
10. [Certification](#10-certification)
---
## 1. Introduction et Contexte
### 1.1 Pourquoi un Standard de Nomenclature ?
**Problèmes avant le standard :**
- ❌ VMs nommées de façon incohérente (vm1, web-server, test123...)
- ❌ VMIDs attribués au hasard (104, 1523, 999...)
- ❌ IPs non structurées (10.50.100.5, 192.168.1.20...)
- ❌ Impossible de retrouver une ressource rapidement
- ❌ Automatisation difficile (Ansible ne peut pas cibler par pattern)
- ❌ Audit et conformité complexes
**Bénéfices du standard v2.0 :**
- ✅ Identification immédiate de toute ressource
- ✅ VMID → IP → Nom → DNS (cohérence totale)
- ✅ Automatisation facilitée (scripts, Ansible, Terraform)
- ✅ Onboarding rapide des nouveaux admins
- ✅ Audit simplifié pour labellisation
- ✅ Scalabilité (999 tenants, 99 instances par type)
### 1.2 Architecture de L'Alliance
**Rappel : Chaque membre est autonome**
```
┌─────────────────────────────────────────┐
│ INTERNET PUBLIC │
└───────────┬─────────────────────────────┘
│
┌───────┼───────┐
│ │ │
┌───▼───┐ ┌─▼───┐ ┌─▼───┐
│ CZP │ │ NUL │ │ TLI │ ← Chaque membre
│ NAT │ │ NAT │ │ NAT │ derrière NAT
└───┬───┘ └──┬──┘ └──┬──┘
│ │ │
│ 10.0.0.0/8 (local, identique partout)
│ = Pas de conflit car isolé
│
└────────┴───────┴──────→ 172.16.0.0/12
(fédération via tunnels)
```
**Point clé :** Tous les membres utilisent **10.0.0.0/8** localement sans conflit.
---
## 2. Module 1 : Comprendre le Standard
### 2.1 Les 4 Piliers de la Nomenclature
```
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ VMID │ ←→ │ IP │ ←→ │ Nom VM │ ←→ │ DNS │
│ 02001 │ │10.0.2.10│ │czp-infra│ │dns.infra│
│ │ │ │ │-dns-... │ │.czp.ab │
└─────────┘ └─────────┘ └─────────┘ └─────────┘
```
**Tous ces éléments sont liés !**
### 2.2 Les Deux Catégories de VMs
#### **A) Infrastructure Fédéré (Couches 1-4)**
Services propres au membre :
- **Couche 1** : Monitoring matériel
- **Couche 2** : DNS, VPN, Réseau
- **Couche 3** : Stockage (Ceph, NFS, Backups)
- **Couche 4** : Orchestration (Ansible, Git, CI/CD)
#### **B) Tenants (Couches 5-8)**
VMs des clients hébergés :
- Chaque client = 1 tenant
- Tenant 001, 002, 003...
- Services web, DB, API, workers...
### 2.3 Vue d'Ensemble du Plan
```
10.0.0.0/8 (Espace Interne Membre)
│
├── 10.0.0.0/24 Management
├── 10.0.1.0/24 Platform Services
├── 10.0.2.0/24 Public DNS
├── 10.0.20.0/22 Reserved Infrastructure
│
├── 10.0.10.0/23 Tenant Infrastructure
└── 10.0.128.0/17 Expansion (50% du /8)
```
---
## 3. Module 2 : VMID Mnémotechnique
### 3.1 Format Infrastructure : `0CTTII`
```
0 = Infrastructure (fixe)
C = Couche (1, 2, 3, ou 4)
TT = Type de service (00-99)
II = Instance (01-99)
```
**Exemples :**
```
02001 = 0-2-00-01
│ │ │ └── Instance 1
│ │ └───── DNS (type 00)
│ └──────── Couche 2 (Réseau)
└────────── Infrastructure
04201 = 0-4-20-01
│ │ │ └── Instance 1
│ │ └───── Git (type 20)
│ └──────── Couche 4 (Orchestration)
└────────── Infrastructure
```
### 3.2 Format Tenant : `TTTII`
```
TTT = Tenant ID (001-999)
II = Instance (01-99)
```
**Exemples :**
```
10001 = 100-01
│ └── Instance 1
└────── Tenant 001
10021 = 100-21
│ └── Instance 21 (convention: DB)
└────── Tenant 001
20001 = 200-01
│ └── Instance 1
└────── Tenant 002
```
### 3.3 Table de Référence Rapide
| Type | VMID | Décodage | Description |
|------|------|----------|-------------|
| Infra | 02001 | Couche 2, DNS, Instance 1 | PowerDNS Master |
| Infra | 02002 | Couche 2, DNS, Instance 2 | PowerDNS Slave 1 |
| Infra | 02101 | Couche 2, VPN, Instance 1 | WireGuard Gateway |
| Infra | 04001 | Couche 4, Ansible, Instance 1 | Ansible Controller |
| Tenant | 10001 | Tenant 001, Instance 1 | Web Frontend |
| Tenant | 10021 | Tenant 001, Instance 21 | Database |
| Tenant | 20001 | Tenant 002, Instance 1 | Web Frontend |
### 3.4 Exercice 1 : Décodage VMID
**Décoder ces VMIDs :**
1. 03301 → ?
2. 04201 → ?
3. 30011 → ?
<details>
<summary>Voir les réponses</summary>
1. **03301** = Infrastructure, Couche 3 (Stockage), Type 30 (Backup), Instance 1 → Proxmox Backup Server
2. **04201** = Infrastructure, Couche 4 (Orchestration), Type 20 (Git), Instance 1 → Forgejo
3. **30011** = Tenant 003, Instance 11 → Backend API tenant 003
</details>
### 3.5 Exercice 2 : Choix VMID
**Quel VMID pour :**
1. Un nouveau DNS Slave (3ème) ?
2. La 1ère VM web du tenant 005 ?
3. Un nouveau CI/CD runner (2ème) ?
<details>
<summary>Voir les réponses</summary>
1. **02003** (Couche 2, DNS type 00, Instance 3)
2. **50001** (Tenant 005, Instance 01)
3. **04102** (Couche 4, CI type 10, Instance 2)
</details>
---
## 4. Module 3 : Plan d'Adressage IP
### 4.1 Segmentation Infrastructure
```
10.0.0.0/24 → Management
.1 → Gateway
.10-.50 → Hyperviseurs Proxmox
.100-.200 → Monitoring
10.0.1.0/24 → Platform Services
.10 → Ansible (04001)
.20 → Git (04201)
.30 → DB Platform (04301)
.40 → API Admin (04401)
10.0.2.0/24 → Public DNS
.10 → DNS Master (02001)
.11 → DNS Slave 1 (02002)
.12 → DNS Slave 2 (02003)
.20 → VPN Gateway (02101)
```
### 4.2 Allocation Tenants
**Stratégie simple :**
```
10.0.10.0-99 → Tenant 001
10.0.10.100-199 → Tenant 002
10.0.11.0-99 → Tenant 003
...
```
**Ou avec IPAM automatique** (script allocate-ip.sh)
### 4.3 Exercice 3 : Allocation IP
**Quelle IP pour :**
1. Un nouveau PowerDNS Slave 3 ?
2. La 2ème VM web du tenant 001 ?
3. Un 2ème Ansible Controller ?
<details>
<summary>Voir les réponses</summary>
1. **10.0.2.12** (Segmentation DNS : 10.0.2.0/24)
2. **10.0.10.2** (Tenant 001 : 10.0.10.0-99)
3. **10.0.1.11** (Platform Services : 10.0.1.0/24)
</details>
---
## 5. Module 4 : Nomenclature VMs et DNS
### 5.1 Format Nom VM Infrastructure
```
<membre>-infra-<type>-<env>-<instance>
Exemples:
czp-infra-dns-master-prod-01
czp-infra-vpn-gateway-prod-01
czp-infra-ansible-ctrl-prod-01
nul-infra-git-forgejo-prod-01
```
### 5.2 Format Nom VM Tenant
```
<membre>-t<tenant-id>-<type>-<env>-<instance>
Exemples:
czp-t001-web-prod-01
czp-t001-db-postgres-prod-01
czp-t002-api-fastapi-prod-01
```
### 5.3 Format DNS
**Infrastructure :**
```
<service>.infra.<membre>.alliance-boreale.ca
Exemples:
dns-master.infra.czp.alliance-boreale.ca
ansible.infra.czp.alliance-boreale.ca
```
**Tenant :**
```
<service>.t<tenant-id>.<membre>.alliance-boreale.ca
Exemples:
web.t001.czp.alliance-boreale.ca
db.t001.czp.alliance-boreale.ca
```
### 5.4 Exercice 4 : Construction Complète
**Pour un nouveau DNS Slave 3 chez Chezlepro :**
- VMID : ?
- IP : ?
- Nom VM : ?
- DNS : ?
<details>
<summary>Voir les réponses</summary>
- **VMID :** 02003
- **IP :** 10.0.2.12
- **Nom VM :** czp-infra-dns-slave3-prod-01
- **DNS :** dns-slave3.infra.czp.alliance-boreale.ca
</details>
---
## 6. Module 5 : Outils Pratiques
### 6.1 Installation
```bash
# Télécharger les scripts
cd /tmp
wget https://forge.alliance-boreale.ca/tools/scripts-nomenclature-v2.tar.gz
tar xzf scripts-nomenclature-v2.tar.gz
# Installer
sudo bash install-nomenclature-tools.sh
```
### 6.2 Configuration
```bash
# Éditer la configuration
sudo nano /etc/alliance-boreale/nomenclature.conf
# Contenu:
MEMBER_ID="czp"
DNS_DOMAIN="alliance-boreale.ca"
```
### 6.3 Utilisation des Scripts
#### **1. Audit de Conformité**
```bash
# Audit complet
audit-nomenclature.sh
# Résultat attendu
✅ CONFORME | VMID: 02001 | Nom: czp-infra-dns-master-prod-01
❌ NON CONFORME | VMID: 104 | Nom: old-vm
```
#### **2. Génération DNS**
```bash
# Générer zone file
generate-dns-records.sh > dns-records.zone
# Aperçu
dns-master.infra.czp.alliance-boreale.ca. IN A 10.0.2.10
```
#### **3. Validation VMID**
```bash
# Valider un VMID
validate-vmid.sh 02001
# Résultat
✅ VMID VALIDE
Type: Infrastructure
Couche: 2
```
#### **4. Migration VM**
```bash
# Simulation
DRY_RUN=true migrate-vm.sh 104 10001 czp-t001-web-prod-01 10.0.10.1
# Migration réelle
migrate-vm.sh 104 10001 czp-t001-web-prod-01 10.0.10.1
```
### 6.4 Exercice 5 : Utilisation des Scripts
**Tâches à réaliser :**
1. Installer les scripts sur votre Proxmox
2. Exécuter un audit de conformité
3. Valider le VMID 02001
4. Générer les enregistrements DNS
---
## 7. Module 6 : Migration en Pratique
### 7.1 Workflow de Migration Complet
```
┌─────────────────┐
│ 1. AUDIT │ → Identifier VMs non conformes
└────────┬────────┘
│
┌────────▼────────┐
│ 2. PLANIFICATION│ → Déterminer nouveaux VMID/IP/noms
└────────┬────────┘
│
┌────────▼────────┐
│ 3. BACKUP │ → Sauvegarder toutes les VMs
└────────┬────────┘
│
┌────────▼────────┐
│ 4. MIGRATION │ → Migrer par lots (5-10 VMs)
└────────┬────────┘
│
┌────────▼────────┐
│ 5. VALIDATION │ → Vérifier conformité
└────────┬────────┘
│
┌────────▼────────┐
│ 6. DOCUMENTATION│ → Mettre à jour DNS/Inventaire
└────────┬────────┘
│
┌────────▼────────┐
│ 7. NETTOYAGE │ → Supprimer anciennes VMs
└─────────────────┘
```
### 7.2 Exemple de Migration Pas-à-Pas
**Scénario :** Migrer une vieille VM web (VMID 104) vers le standard
#### **Étape 1 : État Actuel**
```bash
# Informations actuelles
VMID: 104
Nom: old-vm-web
IP: 10.50.100.5
```
#### **Étape 2 : Déterminer Nouveaux Attributs**
```bash
# Cette VM est le web du tenant 001
# Nouveaux attributs:
VMID: 10001 (Tenant 001, Instance 01)
IP: 10.0.10.1 (Première IP tenant 001)
Nom: czp-t001-web-prod-01
DNS: web.t001.czp.alliance-boreale.ca
```
#### **Étape 3 : Validation**
```bash
# Vérifier VMID
validate-vmid.sh 10001
# ✅ VMID VALIDE
# Vérifier IP disponible
allocate-ip.sh 001
# ✅ IP DISPONIBLE: 10.0.10.1
```
#### **Étape 4 : Backup**
```bash
# Créer snapshot
vzdump 104 --mode snapshot --compress zstd
```
#### **Étape 5 : Migration Simulation**
```bash
# Test en dry-run
DRY_RUN=true migrate-vm.sh 104 10001 \
czp-t001-web-prod-01 10.0.10.1
# Vérifier la sortie
```
#### **Étape 6 : Migration Réelle**
```bash
# Exécuter migration
migrate-vm.sh 104 10001 czp-t001-web-prod-01 10.0.10.1
# Le script fait:
# 1. Backup
# 2. Arrêt VM
# 3. Clone vers nouveau VMID
# 4. Config nouvelle IP
# 5. Démarrage
```
#### **Étape 7 : Post-Migration**
```bash
# 1. Se connecter à la VM
ssh root@10.0.10.1
# 2. Vérifier et ajuster l'IP dans la VM
nano /etc/network/interfaces
# Changer vers 10.0.10.1/24
# 3. Redémarrer réseau
systemctl restart networking
# 4. Tester connectivité
ping 10.0.0.1
```
#### **Étape 8 : DNS et Inventaire**
```bash
# Ajouter DNS
echo "web.t001.czp.alliance-boreale.ca. IN A 10.0.10.1" >> /etc/bind/zones/...
# Régénérer inventaire
generate-inventory.sh
# Tester avec Ansible
ansible web.t001.czp.alliance-boreale.ca -m ping
```
#### **Étape 9 : Validation Finale**
```bash
# Audit
audit-nomenclature.sh | grep 10001
# ✅ CONFORME | VMID: 10001
# Une fois validé (quelques jours), supprimer ancienne VM
qm destroy 104
```
### 7.3 Checklist de Migration
```
AVANT:
□ Backup complet créé
□ Fenêtre de maintenance planifiée
□ Nouveaux attributs validés (VMID, IP, nom)
□ Plan de rollback documenté
□ Équipe informée
PENDANT:
□ Migration exécutée (script)
□ VM démarre correctement
□ IP configurée dans la VM
□ Connectivité réseau OK
□ Services applicatifs fonctionnels
APRÈS:
□ DNS créé
□ Inventaire Ansible mis à jour
□ Monitoring configuré
□ Documentation à jour
□ Tests de régression OK
□ Ancienne VM supprimée (après validation)
```
---
## 8. Exercices Pratiques
### Exercice 6 : Planification Migration
**Vous avez ces VMs à migrer :**
| VMID | Nom Actuel | IP Actuelle | Type |
|------|------------|-------------|------|
| 100 | dns-server | 192.168.1.10 | DNS Master |
| 105 | web1 | 10.20.30.5 | Web Tenant A |
| 106 | db1 | 10.20.30.6 | DB Tenant A |
| 200 | ansible | 10.10.10.5 | Ansible |
**Complétez le plan de migration :**
| VMID Actuel | Nouveau VMID | Nouveau Nom | Nouvelle IP |
|-------------|--------------|-------------|-------------|
| 100 | ? | ? | ? |
| 105 | ? | ? | ? |
| 106 | ? | ? | ? |
| 200 | ? | ? | ? |
<details>
<summary>Voir les réponses</summary>
| VMID Actuel | Nouveau VMID | Nouveau Nom | Nouvelle IP |
|-------------|--------------|-------------|-------------|
| 100 | 02001 | czp-infra-dns-master-prod-01 | 10.0.2.10 |
| 105 | 10001 | czp-t001-web-prod-01 | 10.0.10.1 |
| 106 | 10021 | czp-t001-db-postgres-prod-01 | 10.0.10.2 |
| 200 | 04001 | czp-infra-ansible-ctrl-prod-01 | 10.0.1.10 |
</details>
### Exercice 7 : Création Nouvelle Infrastructure
**Votre membre rejoint L'Alliance. Créez l'infrastructure minimale (Bronze) :**
**Ressources nécessaires :**
- 1 DNS Master
- 1 Ansible Controller
- 1 Backup Server
**Complétez :**
| Service | VMID | Nom VM | IP | DNS |
|---------|------|--------|-----|-----|
| DNS Master | ? | ? | ? | ? |
| Ansible | ? | ? | ? | ? |
| Backup | ? | ? | ? | ? |
<details>
<summary>Voir les réponses (exemple membre NUL)</summary>
| Service | VMID | Nom VM | IP | DNS |
|---------|------|--------|-----|-----|
| DNS Master | 02001 | nul-infra-dns-master-prod-01 | 10.0.2.10 | dns-master.infra.nul.ab.ca |
| Ansible | 04001 | nul-infra-ansible-ctrl-prod-01 | 10.0.1.10 | ansible.infra.nul.ab.ca |
| Backup | 03301 | nul-infra-pbs-backup-prod-01 | 10.0.1.30 | backup.infra.nul.ab.ca |
</details>
### Exercice 8 : Déploiement Nouveau Tenant
**Un nouveau client (Tenant 005) vous demande :**
- 2 VMs web (load balancing)
- 1 API backend
- 1 Database PostgreSQL
- 1 Redis cache
**Complétez le plan de déploiement :**
| Service | VMID | Nom VM | IP |
|---------|------|--------|----|
| Web 1 | ? | ? | ? |
| Web 2 | ? | ? | ? |
| API | ? | ? | ? |
| DB | ? | ? | ? |
| Redis | ? | ? | ? |
<details>
<summary>Voir les réponses</summary>
| Service | VMID | Nom VM | IP |
|---------|------|--------|----|
| Web 1 | 50001 | czp-t005-web-prod-01 | 10.0.10.40 |
| Web 2 | 50002 | czp-t005-web-prod-02 | 10.0.10.41 |
| API | 50011 | czp-t005-api-fastapi-prod-01 | 10.0.10.42 |
| DB | 50021 | czp-t005-db-postgres-prod-01 | 10.0.10.43 |
| Redis | 50031 | czp-t005-cache-redis-prod-01 | 10.0.10.44 |
**Note :** Convention instance :
- 01-09 : Web/Frontend
- 10-19 : Backend/API
- 20-29 : Databases
- 30-39 : Cache/Queue
</details>
---
## 9. Aide-Mémoire
### 9.1 Carte de Référence Rapide
**À imprimer et garder près de votre écran !**
```
╔════════════════════════════════════════════════════════╗
║ NOMENCLATURE v2.0 - AIDE-MÉMOIRE RAPIDE ║
╠════════════════════════════════════════════════════════╣
║ ║
║ FORMAT VMID INFRASTRUCTURE: 0CTTII ║
║ 0 = Infrastructure ║
║ C = Couche (1-4) ║
║ TT = Type (00-99) ║
║ II = Instance (01-99) ║
║ ║
║ FORMAT VMID TENANT: TTTII ║
║ TTT = Tenant ID (001-999) ║
║ II = Instance (01-99) ║
║ ║
║ PLAN IP INFRASTRUCTURE: ║
║ 10.0.0.0/24 → Management ║
║ 10.0.1.0/24 → Platform Services ║
║ 10.0.2.0/24 → Public DNS ║
║ 10.0.20.0/22 → Reserved ║
║ ║
║ PLAN IP TENANTS: ║
║ 10.0.10.0/23 → Tenant Infrastructure ║
║ 10.0.128.0/17 → Expansion ║
║ ║
║ NOM VM INFRA: ║
║ <membre>-infra-<type>-<env>-<instance> ║
║ Exemple: czp-infra-dns-master-prod-01 ║
║ ║
║ NOM VM TENANT: ║
║ <membre>-t<tenant>-<type>-<env>-<instance> ║
║ Exemple: czp-t001-web-prod-01 ║
║ ║
║ DNS INFRA: ║
║ <service>.infra.<membre>.alliance-boreale.ca ║
║ ║
║ DNS TENANT: ║
║ <service>.t<tenant>.<membre>.alliance-boreale.ca ║
║ ║
║ SCRIPTS UTILES: ║
║ audit-nomenclature.sh # Audit conformité ║
║ validate-vmid.sh <vmid> # Valider VMID ║
║ allocate-ip.sh <tenant> # Allouer IP ║
║ migrate-vm.sh <src> <dst> <nom> <ip> # Migration ║
║ ║
╚════════════════════════════════════════════════════════╝
```
### 9.2 Table des Types de Services
#### Couche 2 - Réseau
```
00-09 : DNS (PowerDNS)
10-19 : VPN/WireGuard
20-29 : Routeurs
30-39 : Proxy/HAProxy
```
#### Couche 3 - Stockage
```
00-09 : Ceph Monitors
10-19 : Ceph OSDs
20-29 : NFS
30-39 : Backup (PBS, Borg)
```
#### Couche 4 - Orchestration
```
00-09 : Ansible
10-19 : CI/CD Runners
20-29 : Git (Forgejo)
30-39 : DB Platform
40-49 : API Admin
```
#### Instances Tenant
```
01-09 : Web/Frontend
10-19 : Backend/API
20-29 : Databases
30-39 : Cache/Queue
40-49 : Workers
```
### 9.3 Commandes Fréquentes
```bash
# Lister toutes les VMs
qm list
# Info VM
qm config <vmid>
# Audit conformité
audit-nomenclature.sh
# Valider VMID
validate-vmid.sh <vmid>
# Générer DNS
generate-dns-records.sh > dns.zone
# Générer inventaire
generate-inventory.sh
# Migration (simulation)
DRY_RUN=true migrate-vm.sh <src> <dst> <nom> <ip>
# Allouer IP tenant
allocate-ip.sh <tenant-id>
```
---
## 10. Certification
### 10.1 Test de Certification
**Pour valider votre formation, répondez à ces 10 questions :**
#### Question 1
Quel est le VMID pour un 2ème DNS Slave en infrastructure ?
- A) 02002
- B) 20002
- C) 02102
- D) 02200
#### Question 2
Quelle IP pour le 1er Ansible Controller ?
- A) 10.0.0.10
- B) 10.0.1.10
- C) 10.0.2.10
- D) 10.0.4.10
#### Question 3
Quel nom pour la 1ère VM web du tenant 003 (membre czp) ?
- A) czp-web-t003-prod-01
- B) czp-t003-web-prod-01
- C) czp-t003-prod-web-01
- D) czp-tenant003-web-01
#### Question 4
Quel DNS pour l'API du tenant 002 (membre nul) ?
- A) api.nul.t002.alliance-boreale.ca
- B) t002-api.nul.alliance-boreale.ca
- C) api.t002.nul.alliance-boreale.ca
- D) api.tenant002.nul.alliance-boreale.ca
#### Question 5
Quelle plage IP pour l'infrastructure Platform Services ?
- A) 10.0.0.0/24
- B) 10.0.1.0/24
- C) 10.0.2.0/24
- D) 10.0.10.0/24
#### Question 6
Le VMID 30021 correspond à quoi ?
- A) Infrastructure Couche 3, Type 00, Instance 21
- B) Tenant 003, Instance 21
- C) Tenant 300, Instance 21
- D) Infrastructure Couche 30, Instance 21
#### Question 7
Combien de tenants maximum peut supporter ce standard ?
- A) 99
- B) 999
- C) 9999
- D) Illimité
#### Question 8
Quelle commande pour valider un VMID ?
- A) check-vmid.sh
- B) validate-vmid.sh
- C) test-vmid.sh
- D) verify-vmid.sh
#### Question 9
Avant une migration, quelle est la PREMIÈRE étape ?
- A) Arrêter la VM
- B) Créer un backup
- C) Changer le VMID
- D) Modifier l'IP
#### Question 10
Où sont stockées les allocations IP des tenants ?
- A) /etc/proxmox/ipam.txt
- B) /var/lib/ipam/allocations.txt
- C) /etc/alliance-boreale/ipam.txt
- D) /etc/network/ipam.conf
### 10.2 Réponses
<details>
<summary>Cliquer pour voir les réponses</summary>
1. **A** - 02002 (Couche 2, DNS type 00, Instance 2)
2. **B** - 10.0.1.10 (Platform Services)
3. **B** - czp-t003-web-prod-01
4. **C** - api.t002.nul.alliance-boreale.ca
5. **B** - 10.0.1.0/24
6. **B** - Tenant 003, Instance 21 (probablement une DB)
7. **B** - 999 tenants (001-999)
8. **B** - validate-vmid.sh
9. **B** - Créer un backup
10. **C** - /etc/alliance-boreale/ipam.txt
**Score :**
- 10/10 : ✅ Certifié Expert Nomenclature v2.0
- 8-9/10 : ✅ Certifié avec révision mineure
- 6-7/10 : ⚠️ Révision recommandée
- <6/10 : ❌ Formation à reprendre
</details>
### 10.3 Exercice Pratique Final
**Déploiement complet d'un nouveau membre :**
**Scénario :** Vous êtes le nouvel administrateur de "TechnoLibre" (tli), membre #003 de L'Alliance. Vous devez déployer l'infrastructure minimale Bronze + 1 premier tenant.
**Livrables attendus :**
1. **Plan d'infrastructure (3 VMs minimum) :**
- DNS Master
- Ansible Controller
- Backup Server
2. **Plan tenant 001 (3 VMs) :**
- Web Frontend
- API Backend
- Database PostgreSQL
3. **Documentation complète pour chaque VM :**
- VMID
- Nom VM
- IP
- DNS
4. **Scripts de création :**
- Commandes qm create pour chaque VM
- Commandes de configuration réseau
5. **Zone DNS complète**
**Créez un document avec tous ces éléments !**
---
## Ressources Supplémentaires
### Documentation
- **Standard Nomenclature v2.0** : https://docs.alliance-boreale.ca/nomenclature-v2
- **Scripts** : https://forge.alliance-boreale.ca/tools/nomenclature-scripts
- **Vidéos** : https://video.alliance-boreale.ca/nomenclature
### Support
- **Email** : technique@alliance-boreale.ca
- **Matrix** : #technique:alliance-boreale.ca
- **Forum** : https://forum.alliance-boreale.ca/c/nomenclature
### Communauté
- **Partage de configurations** : https://forge.alliance-boreale.ca/configs
- **Retours d'expérience** : https://blog.alliance-boreale.ca/tag/nomenclature
---
## Conclusion
### Ce que vous avez appris
✅ Comprendre la philosophie du standard v2.0
✅ Maîtriser le format VMID mnémotechnique
✅ Connaître le plan d'adressage IP complet
✅ Construire des noms VMs et DNS conformes
✅ Utiliser les scripts de migration et audit
✅ Planifier et exécuter une migration complète
### Prochaines Étapes
1. **Pratiquer** sur un environnement de test
2. **Auditer** votre infrastructure actuelle
3. **Planifier** la migration progressive
4. **Documenter** votre plan
5. **Valider** avec le Cercle Technique
6. **Migrer** par lots sur 6-12 mois
### Engagement
En tant qu'administrateur certifié Nomenclature v2.0, vous vous engagez à :
- Respecter le standard pour tous nouveaux déploiements
- Participer à la migration progressive de l'existant
- Partager vos retours d'expérience avec la communauté
- Former les nouveaux administrateurs de votre membre
---
**« Une nomenclature maîtrisée = Une infrastructure maîtrisée »**
---
**FIN DU GUIDE DE FORMATION**
**Version :** 1.0
**Date :** 21 octobre 2025
**Licence :** CC-BY-SA 4.0
**Auteur :** L'Alliance Boréale - Cercle Technique

1033
docs/architecture/nomenclature_v2(1).md Normal file
View file

File diff suppressed because it is too large Load diff

1033
docs/architecture/nomenclature_v2.md Normal file
View file

File diff suppressed because it is too large Load diff

244
docs/architecture/readme_package.md Normal file
View file

@ -0,0 +1,244 @@
# Package Complet - Nomenclature v2.0
## L'Alliance Boréale
**Version :** 1.0
**Date :** 21 octobre 2025
**Licence :** AGPL-3.0 (code) / CC-BY-SA 4.0 (documentation)
---
## 📦 Contenu du Package
Ce package complet contient **tout ce dont vous avez besoin** pour adopter le Standard de Nomenclature v2.0 dans votre infrastructure Proxmox.
### 📚 Documentation (5 documents)
1. **Standard de Nomenclature v2.0** (60+ pages)
- Spécification complète du standard
- Format VMID, IP, noms VMs, DNS
- Tables de correspondance exhaustives
- Procédures opérationnelles
2. **Scripts de Migration et d'Audit** (documentation + 6 scripts)
- `audit-nomenclature.sh` - Audit de conformité
- `generate-dns-records.sh` - Génération zone DNS
- `generate-inventory.sh` - Génération inventaire Ansible
- `migrate-vm.sh` - Migration assistée
- `validate-vmid.sh` - Validation VMID
- `allocate-ip.sh` - Allocation IP tenants
3. **Guide de Formation** (40+ pages)
- Formation complète 2-3 heures
- 8 exercices pratiques avec solutions
- Aide-mémoire imprimable
- Test de certification (10 questions)
4. **Templates Ansible & Terraform**
- Modules Ansible (création VM, audit, compliance)
- Modules Terraform (infra + tenants)
- Exemples d'utilisation
- Makefile d'automatisation
5. **README Package** (ce document)
- Vue d'ensemble
- Quick Start
- Troubleshooting
---
## 🚀 Quick Start (15 minutes)
### Étape 1 : Installation des Scripts
```bash
# Télécharger le package
wget https://forge.alliance-boreale.ca/nomenclature-v2-package.tar.gz
tar xzf nomenclature-v2-package.tar.gz
cd nomenclature-v2
# Installer les scripts
sudo bash scripts/install-nomenclature-tools.sh
# Configuration
# Suivre les prompts pour MEMBER_ID et DNS_DOMAIN
```
### Étape 2 : Premier Audit
```bash
# Lancer un audit de conformité
audit-nomenclature.sh
# Résultat attendu :
# ✅ VMs conformes : X
# ❌ VMs non conformes : Y
# Taux de conformité: Z%
```
### Étape 3 : Validation d'un VMID
```bash
# Tester la validation
validate-vmid.sh 02001
# Résultat :
# ✅ VMID VALIDE
# Type: Infrastructure
# Couche: 2 (Réseau)
```
### Étape 4 : Première Migration (Simulation)
```bash
# Migration en mode dry-run
DRY_RUN=true migrate-vm.sh 104 10001 \
czp-t001-web-prod-01 10.0.10.1
# Vérifier la sortie avant de lancer en réel
```
### Étape 5 : Documentation
```bash
# Lire le standard complet
less docs/Standard_Nomenclature_v2.0.md
# Lire le guide de formation
less docs/Guide_Formation_v2.0.md
```
---
## 📖 Structure du Package
```
nomenclature-v2/
│
├── README.md # Ce fichier
├── LICENSE # AGPL-3.0
│
├── docs/
│ ├── Standard_Nomenclature_v2.0.md # Spec complète
│ ├── Guide_Formation_v2.0.md # Formation
│ └── aide-memoire.pdf # Carte de référence
│
├── scripts/
│ ├── install-nomenclature-tools.sh # Installation
│ ├── audit-nomenclature.sh # Audit
│ ├── generate-dns-records.sh # DNS
│ ├── generate-inventory.sh # Inventaire
│ ├── migrate-vm.sh # Migration
│ ├── validate-vmid.sh # Validation
│ └── allocate-ip.sh # Allocation IP
│
├── ansible/
│ ├── inventory/
│ │ └── proxmox.yml # Inventaire dynamique
│ ├── playbooks/
│ │ ├── create-infra-vm.yml # Création VM infra
│ │ ├── create-tenant-vm.yml # Création VM tenant
│ │ └── audit-nomenclature.yml # Audit Ansible
│ └── roles/
│ └── nomenclature_compliance/ # Role de conformité
│
├── terraform/
│ ├── modules/
│ │ ├── infra-vm/ # Module VM infrastructure
│ │ └── tenant-vm/ # Module VM tenant
│ ├── examples/
│ │ ├── bronze-infra/ # Infrastructure Bronze
│ │ ├── silver-infra/ # Infrastructure Argent
│ │ └── tenant-stack/ # Stack tenant complète
│ ├── main.tf # Exemple principal
│ ├── variables.tf # Variables
│ └── outputs.tf # Outputs
│
├── templates/
│ ├── vm-creation-request.md # Template demande création VM
│ ├── migration-plan.md # Template plan de migration
│ └── compliance-report.md # Template rapport conformité
│
└── examples/
├── infrastructure-bronze.txt # Exemple infra Bronze
├── infrastructure-gold.txt # Exemple infra Or
└── tenant-multiservice.txt # Exemple tenant complet
```
---
## 💡 Cas d'Usage
### 1. Audit de Conformité de l'Existant
```bash
# Lancer audit
audit-nomenclature.sh > audit-$(date +%Y%m%d).log
# Analyser le rapport CSV
grep "NON CONFORME" /tmp/audit-nomenclature-*.csv
# Créer plan de migration
cat audit-*.log | grep "NON CONFORME" > migration-todo.txt
```
### 2. Création Nouvelle VM Infrastructure
**Option A : Script interactif**
```bash
ansible-playbook ansible/playbooks/create-infra-vm.yml
# Suivre les prompts
```
**Option B : Terraform**
```bash
cd terraform/examples/bronze-infra
terraform init
terraform plan
terraform apply
```
**Option C : Manuel**
```bash
# 1. Déterminer VMID
validate-vmid.sh 02003 # DNS Slave 3
# 2. Créer VM
qm create 02003 \
--name czp-infra-dns-slave3-prod-01 \
--clone debian-12-template \
--net0 virtio,bridge=vmbr0,tag=2 \
--ipconfig0 ip=10.0.2.12/24,gw=10.0.0.1
# 3. Ajouter DNS
echo "dns-slave3.infra.czp.alliance-boreale.ca. IN A 10.0.2.12" \
>> /var/lib/alliance-boreale/dns-records.zone
```
### 3. Migration Progressive
```bash
# Étape 1 : Audit initial
audit-nomenclature.sh
# Étape 2 : Créer plan (fichier CSV)
# migration-plan.csv :
# VMID_SRC,VMID_DST,NAME,IP
# 104,10001,czp-t001-web-prod-01,10.0.10.1
# 105,10011,czp-t001-api-prod-01,10.0.10.3
# Étape 3 : Migrer par lots
while IFS=, read -r src dst name ip; do
echo "Migration $src -> $dst"
DRY_RUN=true migrate-vm.sh "$src" "$dst" "$name" "$ip"
read -p "Continuer? (y/n) " -n 1 -r
if [[ $REPLY =~ ^[Yy]$ ]]; then
migrate-vm.sh "$src" "$dst" "$name" "$ip"
fi
done < migration-plan.csv
```
### 4. Déploiement Nouveau Tenant
```bash
# Via Ansible
ansible-playbook ansible/playbooks/

431
docs/architecture/resolution_adoption.md Normal file
View file

@ -0,0 +1,431 @@
# RÉSOLUTION D'ADOPTION
## Standard de Nomenclature v2.0
### L'Alliance Boréale
---
**Numéro de résolution :** 2025-TECH-001
**Date de proposition :** 21 octobre 2025
**Cercle émetteur :** Cercle Technique
**Processus :** Consentement Sociocratique
**Statut :** PROPOSITION (en attente de validation)
---
## CONTEXTE
### Situation Actuelle
L'Alliance Boréale compte actuellement **3 membres actifs** (Chezlepro, Nuage Libre, TechnoLibre) avec une infrastructure totale d'environ **120 machines virtuelles** réparties entre infrastructure propre et tenants hébergés.
**Problématiques identifiées :**
1. **Absence de standard unifié** pour l'identification des ressources
2. **Nomenclature incohérente** entre les membres (VMIDs, noms, IPs)
3. **Difficultés d'automatisation** (Ansible, Terraform) dues au manque de structure
4. **Complexité d'audit** pour la labellisation (Bronze, Argent, Or, Platine)
5. **Onboarding lent** des nouveaux administrateurs
6. **Risques opérationnels** (erreurs de manipulation, confusion)
### Besoins Exprimés
Lors des réunions du Cercle Technique (août-octobre 2025), les membres ont exprimé le besoin de :
- ✅ **Standardiser** l'identification de toutes les ressources (VMs, IPs, DNS)
- ✅ **Faciliter l'automatisation** avec des patterns prévisibles
- ✅ **Simplifier les audits** de conformité pour la labellisation
- ✅ **Accélérer l'onboarding** avec une documentation claire
- ✅ **Améliorer la scalabilité** (prévoir 999 tenants par membre)
---
## PROPOSITION
### Objet de la Résolution
**IL EST PROPOSÉ** d'adopter le **Standard de Nomenclature v2.0** comme standard officiel de L'Alliance Boréale pour l'identification et l'organisation des ressources d'infrastructure.
### Composants du Standard
Le Standard de Nomenclature v2.0 comprend :
#### 1. Spécification Technique (60+ pages)
- Format VMID mnémotechnique (0CTTII pour infra, TTTII pour tenants)
- Plan d'adressage IP unifié (10.0.0.0/8 par membre, derrière NAT)
- Nomenclature VMs (<membre>-infra/t<XXX>-<type>-<env>-<inst>)
- Nomenclature DNS (<service>.infra/t<XXX>.<membre>.alliance-boreale.ca)
- Tables de correspondance complètes
#### 2. Outillage (6 scripts)
- `audit-nomenclature.sh` - Audit de conformité
- `generate-dns-records.sh` - Génération zone DNS
- `generate-inventory.sh` - Génération inventaire Ansible
- `migrate-vm.sh` - Migration assistée avec simulation
- `validate-vmid.sh` - Validation format VMID
- `allocate-ip.sh` - Allocation IP tenants (IPAM)
#### 3. Formation et Documentation
- Guide de formation (40+ pages, 8 exercices pratiques)
- Test de certification (10 questions + exercice final)
- Templates Ansible et Terraform
- Aide-mémoire imprimable
#### 4. Gouvernance
- Processus de révision annuelle
- Procédures de modification (RFC)
- Versionnage sémantique (v2.x.x)
---
## MODALITÉS D'ADOPTION
### 1. Adoption du Standard
**IL EST RÉSOLU :**
**QUE** le Standard de Nomenclature v2.0, tel que documenté dans le package complet daté du 21 octobre 2025, soit adopté comme **standard officiel obligatoire** pour tous les membres de L'Alliance Boréale.
### 2. Date d'Entrée en Vigueur
**QUE** ce standard entre en vigueur selon le calendrier suivant :
- **Immédiat (21 octobre 2025)** : Publication officielle du standard
- **1er décembre 2025** : Formation obligatoire de tous les administrateurs
- **1er janvier 2026** : Obligation pour tous **nouveaux déploiements**
- **31 décembre 2026** : Objectif de conformité à 100% pour l'existant
### 3. Obligations des Membres
**QUE** chaque membre s'engage à :
#### A) Formation (avant 1er décembre 2025)
- [ ] Former tous les administrateurs système (min. 1 par membre)
- [ ] Certifier au moins 1 administrateur par membre (niveau 2)
- [ ] Désigner 1 "référent nomenclature" par membre
#### B) Nouveaux Déploiements (à partir du 1er janvier 2026)
- [ ] Respecter le standard v2.0 pour **toute nouvelle VM**
- [ ] Utiliser les scripts fournis pour validation (validate-vmid.sh)
- [ ] Documenter toute exception (avec justification validée)
#### C) Migration de l'Existant (avant 31 décembre 2026)
- [ ] Réaliser un audit initial (avant 31 janvier 2026)
- [ ] Établir un plan de migration (avant 28 février 2026)
- [ ] Migrer par lots (5-10 VMs/mois minimum)
- [ ] Atteindre 80% de conformité avant 30 juin 2026
- [ ] Atteindre 100% de conformité avant 31 décembre 2026
#### D) Reporting
- [ ] Rapport mensuel de conformité au Cercle Technique
- [ ] Partage des retours d'expérience (bonnes pratiques, difficultés)
### 4. Ressources Allouées
**QUE** L'Alliance Boréale alloue les ressources suivantes :
#### Coordination (Banque de Temps)
- **30 heures** : Animation sessions de formation (réparties entre experts)
- **20 heures** : Support technique aux membres (canal dédié Matrix)
- **10 heures** : Maintenance documentation et scripts
#### Infrastructure Commune
- **Forge Git** : Hébergement du code et documentation
- **Wiki** : Documentation interactive et exemples
- **Forum** : Entraide entre membres
#### Budget Financier (si nécessaire)
- **0 $** : Tout en logiciel libre et Banque de Temps
- **Réserve** : 500 $ pour formation externe si expertise manquante
### 5. Exceptions et Dérogations
**QUE** des exceptions puissent être accordées selon ce processus :
#### Cas Justifiant une Exception
- Contraintes techniques insurmontables (matériel legacy)
- Dépendances externes non migrables à court terme
- Coût de migration disproportionné pour VM en fin de vie
#### Processus d'Exception
1. **Demande écrite** au Cercle Technique (formulaire dédié)
2. **Justification technique** détaillée + impact + alternatives explorées
3. **Validation** par 2 experts du Cercle Technique
4. **Durée limitée** : Max 12 mois, renouvellement possible 1 fois
5. **Plan de mise en conformité** obligatoire dans la demande
#### Registre des Exceptions
- Tenu à jour dans `governance/nomenclature-exceptions.yml`
- Consultation publique par tous les membres
- Révision trimestrielle par le Cercle Technique
### 6. Maintenance et Évolution
**QUE** le standard soit maintenu selon ces principes :
#### Responsabilité
- **Propriétaire** : Cercle Technique de L'Alliance Boréale
- **Gardien du standard** : 1 membre désigné (rotation annuelle)
- **Contributeurs** : Tous les membres (via RFC)
#### Révisions
- **Mineures (v2.x)** : Corrections, clarifications → Validation Cercle Technique
- **Majeures (v3.0)** : Changements structurels → Consentement tous membres
- **Fréquence** : Révision annuelle obligatoire (octobre)
#### Processus RFC (Request for Comments)
1. Proposition ouverte sur la forge (`rfc/NNNN-titre.md`)
2. Discussion publique (min. 2 semaines)
3. Présentation au Cercle Technique
4. Décision par consentement (si impact majeur)
5. Intégration dans version suivante
---
## IMPACTS ET BÉNÉFICES ATTENDUS
### Impacts Positifs
#### Court Terme (6 mois)
- ✅ **Clarté opérationnelle** : Toute ressource identifiable immédiatement
- ✅ **Réduction erreurs** : -80% d'erreurs de manipulation (estimation)
- ✅ **Automatisation** : Playbooks Ansible génériques réutilisables
- ✅ **Onboarding** : Temps de formation -50% pour nouveaux admins
#### Moyen Terme (1 an)
- ✅ **Conformité audits** : Simplification audits de labellisation
- ✅ **Scalabilité** : Capacité d'accueillir 999 tenants par membre
- ✅ **Professionnalisme** : Crédibilité renforcée de L'Alliance
- ✅ **Collaboration** : Entraide facilitée entre membres
#### Long Terme (2 ans)
- ✅ **Maturité** : Infrastructure de niveau "entreprise"
- ✅ **Résilience** : Documentation permettant continuité en cas de départ
- ✅ **Innovation** : Base solide pour outils avancés (IPAM auto, API)
- ✅ **Rayonnement** : Standard pouvant influencer la communauté Proxmox
### Impacts Négatifs (Mitigations)
#### Charge de Travail Initiale
- ⚠️ **Impact** : ~40h par membre pour migration complète
- ✅ **Mitigation** : Migration progressive sur 12 mois, scripts d'assistance
#### Courbe d'Apprentissage
- ⚠️ **Impact** : 3h de formation par administrateur
- ✅ **Mitigation** : Documentation claire, exercices pratiques, certification
#### Résistance au Changement
- ⚠️ **Impact** : Confort avec l'existant, peur de la complexité
- ✅ **Mitigation** : Démonstrations, retours d'expérience, support dédié
---
## MÉTRIQUES DE SUCCÈS
### Indicateurs Quantitatifs (KPIs)
| Métrique | Valeur Actuelle | Cible 6 mois | Cible 12 mois |
|----------|-----------------|--------------|---------------|
| **Taux de conformité VMs** | 0% | 50% | 100% |
| **Admins formés** | 0/9 | 6/9 (67%) | 9/9 (100%) |
| **Admins certifiés** | 0/9 | 3/9 (33%) | 6/9 (67%) |
| **Temps onboarding nouvel admin** | 2 jours | 1 jour | 0.5 jour |
| **Erreurs de manipulation/mois** | ~10 | <5 | <2 |
| **Temps audit conformité** | 4h | 1h | 0.5h (automatisé) |
### Indicateurs Qualitatifs
- **Satisfaction administrateurs** : Sondage trimestriel (cible >4/5)
- **Qualité documentation** : Feedback utilisateurs (cible >4/5)
- **Facilité d'automatisation** : Nombre de playbooks réutilisables
- **Rayonnement externe** : Mentions dans communauté Proxmox
---
## RISQUES ET PLAN DE CONTINGENCE
### Risques Identifiés
#### Risque 1 : Faible Adoption
- **Probabilité** : Faible
- **Impact** : Élevé
- **Mitigation** : Obligation pour nouveaux déploiements, formation obligatoire
- **Contingence** : Accompagnement renforcé, exemples concrets
#### Risque 2 : Standard Trop Complexe
- **Probabilité** : Moyenne
- **Impact** : Moyen
- **Mitigation** : Formation de qualité, scripts d'assistance
- **Contingence** : Simplification v2.1 si feedback négatif massif
#### Risque 3 : Coût Migration Sous-Estimé
- **Probabilité** : Moyenne
- **Impact** : Moyen
- **Mitigation** : Timeline souple (12 mois), migration progressive
- **Contingence** : Extension deadline si justifié (vote)
#### Risque 4 : Obsolescence Rapide
- **Probabilité** : Faible
- **Impact** : Élevé
- **Mitigation** : Processus RFC, révision annuelle
- **Contingence** : Refonte v3.0 si changement technologique majeur
---
## PROCESSUS DE VALIDATION
### Étapes de Validation
#### 1. Révision Technique (Semaine 1-2)
- [ ] Lecture du package complet par tous les membres du Cercle Technique
- [ ] Identification des points d'amélioration
- [ ] Soumission des commentaires (forge Git ou Matrix)
#### 2. Intégration Retours (Semaine 3)
- [ ] Consolidation des retours par le responsable du standard
- [ ] Modifications du standard (version 2.0.1 si nécessaire)
- [ ] Publication version révisée
#### 3. Réunion de Validation (Semaine 4)
- [ ] Réunion du Cercle Technique (2-3 heures)
- [ ] Présentation du standard (30 min)
- [ ] Questions/Réponses (30 min)
- [ ] Tour de consentement (30 min)
- [ ] Formalisation de la résolution
#### 4. Vote de Consentement
- [ ] Chaque membre exprime son consentement ou objection
- [ ] Si objection : Discussion et recherche de solutions
- [ ] Si aucune objection bloquante : **Résolution adoptée**
### Critères de Consentement
Un membre donne son **consentement** s'il peut affirmer :
> "Je n'ai pas d'objection raisonnable et argumentée qui rendrait l'adoption de ce standard **nuisible** pour L'Alliance ou pour mon organisation."
**Note** : Le consentement n'est PAS l'unanimité. Un membre peut avoir des réserves mineures tout en donnant son consentement.
---
## SIGNATURES ET ADOPTION
### Proposition Initiale
**Proposé par :**
- **Daniel Mathieu** - Président, Chezlepro (czp-001)
- **Cercle Technique** - L'Alliance Boréale
**Date de proposition :** 21 octobre 2025
---
### Consentement des Membres
#### Chezlepro (czp-001)
- [ ] **Consentement** donné le : ________________
- [ ] **Objection** (détails ci-dessous) :
**Signature :** ________________________
**Nom :** Daniel Mathieu
**Fonction :** Président / Administrateur Système
---
#### Nuage Libre (nul-002)
- [ ] **Consentement** donné le : ________________
- [ ] **Objection** (détails ci-dessous) :
**Signature :** ________________________
**Nom :** ______________________________
**Fonction :** ______________________________
---
#### TechnoLibre (tli-003)
- [ ] **Consentement** donné le : ________________
- [ ] **Objection** (détails ci-dessous) :
**Signature :** ________________________
**Nom :** ______________________________
**Fonction :** ______________________________
---
### Validation Finale
**Résolution adoptée par consentement le :** _______________
**Validé par le Cercle Technique :**
**Signature du Facilitateur :**
________________________
**Nom :** ______________________________
**Date :** ______________________________
---
## ANNEXES
### Annexe A : Documents de Référence
1. **Standard de Nomenclature v2.0** (60+ pages)
- Fichier : `Standard_Nomenclature_v2.0.md`
- Hash SHA256 : `[à calculer après finalisation]`
2. **Scripts de Migration** (6 scripts)
- Répertoire : `scripts/`
- Version : 1.0
3. **Guide de Formation** (40+ pages)
- Fichier : `Guide_Formation_v2.0.md`
4. **Templates Ansible/Terraform**
- Répertoires : `ansible/` et `terraform/`
### Annexe B : Calendrier Détaillé
| Date | Étape | Responsable | Statut |
|------|-------|-------------|--------|
| 21 oct 2025 | Proposition résolution | Daniel Mathieu | ✅ Fait |
| 28 oct 2025 | Révision technique | Cercle Technique | ⏳ En cours |
| 4 nov 2025 | Intégration retours | Daniel Mathieu | 🔜 À venir |
| 11 nov 2025 | Réunion validation | Tous membres | 🔜 À venir |
| 18 nov 2025 | Adoption officielle | Cercle Technique | 🔜 À venir |
| 1 déc 2025 | Début formations | Référents nomenclature | 🔜 À venir |
| 1 jan 2026 | Entrée en vigueur | Tous membres | 🔜 À venir |
### Annexe C : Contacts et Responsabilités
**Gardien du Standard (2025-2026) :**
- Nom : Daniel Mathieu
- Email : daniel@chezlepro.ca
- Matrix : @daniel:chezlepro.ca
**Support Technique :**
- Email : technique@alliance-boreale.ca
- Matrix : #nomenclature:alliance-boreale.ca
**Forge Git :**
- URL : https://forge.alliance-boreale.ca/standards/nomenclature
- Issues : https://forge.alliance-boreale.ca/standards/nomenclature/issues
---
## HISTORIQUE DES RÉVISIONS
| Version | Date | Auteur | Modifications |
|---------|------|--------|---------------|
| 1.0 | 21 oct 2025 | Daniel Mathieu | Proposition initiale |
| 1.1 | [future] | [nom] | [modifications après retours] |
---
**FIN DE LA RÉSOLUTION**
**Résolution n° 2025-TECH-001**
**Standard de Nomenclature v2.0**
**L'Alliance Boréale**
---
**« Un standard adopté par consentement est un standard respecté. »**

1248
docs/architecture/scripts_migration.sh Normal file
View file

File diff suppressed because it is too large Load diff

968
docs/architecture/templates_automation.md Normal file
View file

@ -0,0 +1,968 @@
# Templates Ansible & Terraform - Nomenclature v2.0
# L'Alliance Boréale
#
# Version: 1.0
# Date: 21 octobre 2025
# Licence: AGPL-3.0
################################################################################
# PARTIE 1: TEMPLATES ANSIBLE
################################################################################
# ==============================================================================
# 1. Inventaire Dynamique Proxmox
# ==============================================================================
# inventory/proxmox.yml
---
plugin: community.general.proxmox
url: https://proxmox.example.com:8006
user: ansible@pve
password: !vault |
$ANSIBLE_VAULT;1.1;AES256
...
validate_certs: no
# Grouper automatiquement par tags
compose:
ansible_host: proxmox_ipconfig0.ip | regex_replace('/.*', '')
keyed_groups:
# Grouper par couche (infrastructure)
- prefix: layer
key: proxmox_tags | select('match', '^layer-[1-4]$') | first | default('unknown')
# Grouper par tenant
- prefix: tenant
key: proxmox_tags | select('match', '^tenant-t[0-9]{3}$') | first | default('none')
# Grouper par environnement
- prefix: env
key: proxmox_tags | select('match', '^(prod|stg|dev|test)$') | first | default('unknown')
# Grouper par catégorie
- prefix: category
key: proxmox_tags | select('match', '^(infrastructure|tenant)$') | first | default('unknown')
# ==============================================================================
# 2. Playbook de Création VM Infrastructure
# ==============================================================================
# playbooks/create-infra-vm.yml
---
- name: Créer VM Infrastructure selon nomenclature v2.0
hosts: localhost
gather_facts: no
vars_prompt:
- name: vm_layer
prompt: "Couche (1-4)"
private: no
- name: vm_type
prompt: "Type service (ex: 00=DNS, 10=VPN, 20=Git)"
private: no
- name: vm_instance
prompt: "Instance (01-99)"
private: no
- name: vm_service_name
prompt: "Nom du service (ex: dns-master, ansible-ctrl)"
private: no
- name: vm_environment
prompt: "Environnement (prod/stg/dev/test)"
private: no
default: "prod"
vars:
member_id: "{{ lookup('env', 'MEMBER_ID') | default('czp', true) }}"
# Calcul VMID
vmid: "{{ '%s%02d' | format(tenant_id, vm_instance|int) }}"
# Construction nom VM
vm_name: "{{ member_id }}-t{{ tenant_id }}-{{ vm_service_type }}-{{ vm_environment }}-{{ '%02d' | format(vm_instance|int) }}"
# Allocation IP (via script ou manuel)
vm_ip: "{{ lookup('pipe', 'allocate-ip.sh ' + tenant_id) | regex_search('\\d+\\.\\d+\\.\\d+\\.\\d+') }}"
# DNS
vm_dns: "{{ vm_service_type }}.t{{ tenant_id }}.{{ member_id }}.alliance-boreale.ca"
tasks:
- name: Afficher plan de création
debug:
msg:
- "VMID: {{ vmid }}"
- "Nom: {{ vm_name }}"
- "IP: {{ vm_ip }}/23"
- "DNS: {{ vm_dns }}"
- "Tenant: {{ tenant_id }}"
- name: Confirmer création
pause:
prompt: "Créer cette VM? (Ctrl+C pour annuler)"
- name: Créer VM dans Proxmox
community.general.proxmox_kvm:
api_host: "{{ proxmox_host }}"
api_user: "{{ proxmox_user }}"
api_password: "{{ proxmox_password }}"
node: "{{ proxmox_node }}"
vmid: "{{ vmid }}"
name: "{{ vm_name }}"
clone: "{{ vm_template | default('debian-12-template') }}"
full: yes
cores: "{{ vm_cores | default(2) }}"
memory: "{{ vm_memory | default(2048) }}"
net:
net0: "virtio,bridge=vmbr0,tag=10"
ipconfig:
ipconfig0: "ip={{ vm_ip }}/23,gw=10.0.0.1"
tags:
- tenant
- "tenant-t{{ tenant_id }}"
- "{{ vm_environment }}"
- "service-{{ vm_service_type }}"
state: present
- name: Enregistrer IP dans IPAM
ansible.builtin.lineinfile:
path: "/etc/alliance-boreale/ipam.txt"
line: "{{ tenant_id }} {{ vm_ip }} {{ ansible_date_time.date }} {{ vmid }}"
create: yes
- name: Créer entrée DNS
ansible.builtin.lineinfile:
path: "/var/lib/alliance-boreale/dns-records.zone"
line: "{{ vm_dns }}. IN A {{ vm_ip }}"
delegate_to: "{{ dns_master_host }}"
- name: Démarrer la VM
community.general.proxmox_kvm:
api_host: "{{ proxmox_host }}"
api_user: "{{ proxmox_user }}"
api_password: "{{ proxmox_password }}"
vmid: "{{ vmid }}"
state: started
# ==============================================================================
# 4. Role Ansible - Conformité Nomenclature
# ==============================================================================
# roles/nomenclature_compliance/tasks/main.yml
---
- name: Vérifier que le VMID est conforme
ansible.builtin.assert:
that:
- inventory_hostname_short | regex_search('^[a-z]+-((infra)|(t[0-9]{3}))-')
fail_msg: "Nom VM non conforme au standard v2.0"
success_msg: "Nom VM conforme"
- name: Extraire les informations de nomenclature
ansible.builtin.set_fact:
vm_member: "{{ inventory_hostname_short | regex_replace('^([a-z]+)-.*', '\\1') }}"
vm_category: "{{ 'infrastructure' if 'infra' in inventory_hostname_short else 'tenant' }}"
vm_tenant_id: "{{ inventory_hostname_short | regex_replace('.*-(t[0-9]{3})-.*', '\\1') if 'infra' not in inventory_hostname_short else 'N/A' }}"
- name: Afficher informations extraites
debug:
msg:
- "Membre: {{ vm_member }}"
- "Catégorie: {{ vm_category }}"
- "Tenant: {{ vm_tenant_id }}"
- name: Vérifier cohérence IP
ansible.builtin.assert:
that:
- ansible_default_ipv4.address | regex_search('^10\\.0\\.')
fail_msg: "IP hors de la plage 10.0.0.0/8"
success_msg: "IP dans la plage correcte"
- name: Appliquer tags de conformité
ansible.builtin.set_fact:
nomenclature_compliant: true
nomenclature_version: "v2.0"
nomenclature_validated_date: "{{ ansible_date_time.iso8601 }}"
# ==============================================================================
# 5. Playbook d'Audit Ansible
# ==============================================================================
# playbooks/audit-nomenclature-ansible.yml
---
- name: Audit de conformité Nomenclature v2.0 via Ansible
hosts: all
gather_facts: yes
tasks:
- name: Vérifier nom VM
ansible.builtin.set_fact:
name_compliant: "{{ inventory_hostname_short | regex_search('^[a-z]+-(infra|t[0-9]{3})-[a-z0-9-]+-[a-z]+-[0-9]{2}
vars:
member_id: "{{ lookup('env', 'MEMBER_ID') | default('czp', true) }}"
# Calcul VMID
vmid: "{{ '0%s%02d%02d' | format(vm_layer, vm_type|int, vm_instance|int) }}"
# Construction nom VM
vm_name: "{{ member_id }}-infra-{{ vm_service_name }}-{{ vm_environment }}-{{ '%02d' | format(vm_instance|int) }}"
# Calcul IP selon couche
vm_ip: >-
{{
('10.0.0.' if vm_layer == '1' else
'10.0.1.' if vm_layer == '4' else
'10.0.2.' if vm_layer == '2' else
'10.0.3.') + (vm_type|int * 10 + vm_instance|int)|string
}}
# DNS
vm_dns: "{{ vm_service_name }}.infra.{{ member_id }}.alliance-boreale.ca"
tasks:
- name: Afficher plan de création
debug:
msg:
- "VMID: {{ vmid }}"
- "Nom: {{ vm_name }}"
- "IP: {{ vm_ip }}/24"
- "DNS: {{ vm_dns }}"
- name: Confirmer création
pause:
prompt: "Créer cette VM? (Ctrl+C pour annuler, Entrée pour continuer)"
- name: Créer VM dans Proxmox
community.general.proxmox_kvm:
api_host: "{{ proxmox_host }}"
api_user: "{{ proxmox_user }}"
api_password: "{{ proxmox_password }}"
node: "{{ proxmox_node }}"
vmid: "{{ vmid }}"
name: "{{ vm_name }}"
clone: "debian-12-template"
full: yes
cores: 2
memory: 2048
net:
net0: "virtio,bridge=vmbr0,tag={{ '2' if vm_layer == '2' else '1' }}"
ipconfig:
ipconfig0: "ip={{ vm_ip }}/24,gw=10.0.0.1"
tags:
- infrastructure
- "layer-{{ vm_layer }}"
- "{{ vm_environment }}"
- "service-{{ vm_service_name }}"
state: present
register: vm_created
- name: Démarrer la VM
community.general.proxmox_kvm:
api_host: "{{ proxmox_host }}"
api_user: "{{ proxmox_user }}"
api_password: "{{ proxmox_password }}"
vmid: "{{ vmid }}"
state: started
- name: Créer entrée DNS
ansible.builtin.lineinfile:
path: "/var/lib/alliance-boreale/dns-records.zone"
line: "{{ vm_dns }}. IN A {{ vm_ip }}"
create: yes
delegate_to: "{{ dns_master_host }}"
- name: Ajouter au monitoring
ansible.builtin.template:
src: templates/icinga2-host.conf.j2
dest: "/etc/icinga2/conf.d/hosts/{{ vm_name }}.conf"
delegate_to: "{{ monitoring_host }}"
notify: Reload Icinga2
# ==============================================================================
# 3. Playbook de Création VM Tenant
# ==============================================================================
# playbooks/create-tenant-vm.yml
---
- name: Créer VM Tenant selon nomenclature v2.0
hosts: localhost
gather_facts: no
vars_prompt:
- name: tenant_id
prompt: "Tenant ID (001-999)"
private: no
- name: vm_instance
prompt: "Instance (01-99)"
private: no
- name: vm_service_type
prompt: "Type (web/api/db/cache/worker)"
private: no
- name: vm_environment
prompt: "Environnement (prod/stg/dev) is not none }}"
- name: Vérifier IP dans plage correcte
ansible.builtin.set_fact:
ip_compliant: "{{ ansible_default_ipv4.address | regex_search('^10\\.0\\.') is not none }}"
- name: Extraire VMID si possible
ansible.builtin.shell: |
qm list | awk -v host="{{ inventory_hostname_short }}" '$2 == host {print $1}'
register: vmid_check
delegate_to: "{{ proxmox_node }}"
changed_when: false
failed_when: false
- name: Valider VMID
ansible.builtin.command: validate-vmid.sh {{ vmid_check.stdout }}
register: vmid_validation
delegate_to: localhost
changed_when: false
failed_when: false
when: vmid_check.stdout != ""
- name: Générer rapport
ansible.builtin.set_fact:
compliance_report:
hostname: "{{ inventory_hostname }}"
name_compliant: "{{ name_compliant }}"
ip_compliant: "{{ ip_compliant }}"
vmid: "{{ vmid_check.stdout | default('N/A') }}"
vmid_compliant: "{{ vmid_validation.rc == 0 if vmid_check.stdout != '' else false }}"
overall_compliant: "{{ name_compliant and ip_compliant and (vmid_validation.rc == 0 if vmid_check.stdout != '' else false) }}"
- name: Afficher résultat
ansible.builtin.debug:
var: compliance_report
- name: Sauvegarder rapport
ansible.builtin.copy:
content: "{{ compliance_report | to_nice_json }}"
dest: "/var/lib/alliance-boreale/compliance/{{ inventory_hostname }}.json"
delegate_to: localhost
################################################################################
# PARTIE 2: TEMPLATES TERRAFORM
################################################################################
# ==============================================================================
# 6. Module Terraform - VM Infrastructure
# ==============================================================================
# modules/infra-vm/main.tf
terraform {
required_providers {
proxmox = {
source = "telmate/proxmox"
version = "~> 2.9"
}
}
}
variable "member_id" {
description = "ID du membre (ex: czp, nul, tli)"
type = string
}
variable "layer" {
description = "Couche (1-4)"
type = number
validation {
condition = var.layer >= 1 && var.layer <= 4
error_message = "La couche doit être entre 1 et 4."
}
}
variable "service_type" {
description = "Type de service (00-99)"
type = number
}
variable "instance" {
description = "Numéro d'instance (01-99)"
type = number
}
variable "service_name" {
description = "Nom du service (ex: dns-master, ansible-ctrl)"
type = string
}
variable "environment" {
description = "Environnement (prod/stg/dev/test)"
type = string
default = "prod"
}
variable "cores" {
description = "Nombre de CPU cores"
type = number
default = 2
}
variable "memory" {
description = "RAM en MB"
type = number
default = 2048
}
variable "disk_size" {
description = "Taille disque en GB"
type = string
default = "20G"
}
# Calculs locaux
locals {
# VMID: 0CTTII
vmid = format("0%d%02d%02d", var.layer, var.service_type, var.instance)
# Nom VM: <membre>-infra-<type>-<env>-<instance>
vm_name = format("%s-infra-%s-%s-%02d",
var.member_id,
var.service_name,
var.environment,
var.instance
)
# IP selon couche
ip_base = var.layer == 1 ? "10.0.0" : (
var.layer == 2 ? "10.0.2" : (
var.layer == 3 ? "10.0.3" : "10.0.1"))
vm_ip = format("%s.%d", local.ip_base, var.service_type * 10 + var.instance)
# DNS
vm_dns = format("%s.infra.%s.alliance-boreale.ca",
var.service_name,
var.member_id
)
}
resource "proxmox_vm_qemu" "infra_vm" {
name = local.vm_name
vmid = local.vmid
target_node = var.proxmox_node
clone = "debian-12-template"
full_clone = true
cores = var.cores
memory = var.memory
network {
model = "virtio"
bridge = "vmbr0"
tag = var.layer == 2 ? 2 : 1
}
disk {
type = "scsi"
storage = "local-lvm"
size = var.disk_size
}
ipconfig0 = "ip=${local.vm_ip}/24,gw=10.0.0.1"
tags = join(";", [
"infrastructure",
"layer-${var.layer}",
var.environment,
"service-${var.service_name}",
"nomenclature-v2"
])
lifecycle {
ignore_changes = [
network,
]
}
}
output "vmid" {
value = local.vmid
}
output "vm_name" {
value = local.vm_name
}
output "vm_ip" {
value = local.vm_ip
}
output "vm_dns" {
value = local.vm_dns
}
# ==============================================================================
# 7. Module Terraform - VM Tenant
# ==============================================================================
# modules/tenant-vm/main.tf
terraform {
required_providers {
proxmox = {
source = "telmate/proxmox"
version = "~> 2.9"
}
}
}
variable "member_id" {
description = "ID du membre"
type = string
}
variable "tenant_id" {
description = "Tenant ID (001-999)"
type = string
validation {
condition = can(regex("^[0-9]{3}$", var.tenant_id))
error_message = "Tenant ID doit être au format NNN (ex: 001)."
}
}
variable "instance" {
description = "Numéro d'instance (01-99)"
type = number
}
variable "service_type" {
description = "Type de service (web/api/db/cache/worker)"
type = string
}
variable "environment" {
description = "Environnement"
type = string
default = "prod"
}
variable "ip_address" {
description = "Adresse IP (optionnel, auto-alloué si vide)"
type = string
default = ""
}
variable "cores" {
type = number
default = 2
}
variable "memory" {
type = number
default = 2048
}
locals {
# VMID: TTTII
vmid = format("%s%02d", var.tenant_id, var.instance)
# Nom VM
vm_name = format("%s-t%s-%s-%s-%02d",
var.member_id,
var.tenant_id,
var.service_type,
var.environment,
var.instance
)
# IP (utiliser celle fournie ou calculer)
vm_ip = var.ip_address != "" ? var.ip_address : format("10.0.10.%d",
(tonumber(var.tenant_id) - 1) * 10 + var.instance
)
# DNS
vm_dns = format("%s.t%s.%s.alliance-boreale.ca",
var.service_type,
var.tenant_id,
var.member_id
)
}
resource "proxmox_vm_qemu" "tenant_vm" {
name = local.vm_name
vmid = local.vmid
target_node = var.proxmox_node
clone = var.vm_template
full_clone = true
cores = var.cores
memory = var.memory
network {
model = "virtio"
bridge = "vmbr0"
tag = 10
}
disk {
type = "scsi"
storage = "local-lvm"
size = var.disk_size
}
ipconfig0 = "ip=${local.vm_ip}/23,gw=10.0.0.1"
tags = join(";", [
"tenant",
"tenant-t${var.tenant_id}",
var.environment,
"service-${var.service_type}",
"nomenclature-v2"
])
}
# Enregistrer dans IPAM
resource "null_resource" "register_ipam" {
provisioner "local-exec" {
command = "echo '${var.tenant_id} ${local.vm_ip} ${timestamp()} ${local.vmid}' >> /etc/alliance-boreale/ipam.txt"
}
depends_on = [proxmox_vm_qemu.tenant_vm]
}
output "vmid" {
value = local.vmid
}
output "vm_name" {
value = local.vm_name
}
output "vm_ip" {
value = local.vm_ip
}
output "vm_dns" {
value = local.vm_dns
}
# ==============================================================================
# 8. Exemple d'Utilisation Terraform
# ==============================================================================
# main.tf - Exemple de déploiement complet
terraform {
required_version = ">= 1.0"
required_providers {
proxmox = {
source = "telmate/proxmox"
version = "~> 2.9"
}
}
}
provider "proxmox" {
pm_api_url = var.proxmox_api_url
pm_user = var.proxmox_user
pm_password = var.proxmox_password
pm_tls_insecure = true
}
variable "proxmox_api_url" {}
variable "proxmox_user" {}
variable "proxmox_password" {}
variable "proxmox_node" { default = "pve1" }
variable "member_id" { default = "czp" }
# Infrastructure minimale Bronze
module "dns_master" {
source = "./modules/infra-vm"
member_id = var.member_id
layer = 2
service_type = 0 # DNS
instance = 1
service_name = "dns-master"
cores = 2
memory = 4096
}
module "ansible_controller" {
source = "./modules/infra-vm"
member_id = var.member_id
layer = 4
service_type = 0 # Ansible
instance = 1
service_name = "ansible-ctrl"
}
module "backup_server" {
source = "./modules/infra-vm"
member_id = var.member_id
layer = 3
service_type = 30 # Backup
instance = 1
service_name = "pbs-backup"
cores = 4
memory = 8192
disk_size = "500G"
}
# Premier tenant - Stack complète
module "tenant001_web" {
source = "./modules/tenant-vm"
member_id = var.member_id
tenant_id = "001"
instance = 1
service_type = "web"
}
module "tenant001_api" {
source = "./modules/tenant-vm"
member_id = var.member_id
tenant_id = "001"
instance = 11
service_type = "api-fastapi"
}
module "tenant001_db" {
source = "./modules/tenant-vm"
member_id = var.member_id
tenant_id = "001"
instance = 21
service_type = "db-postgres"
cores = 4
memory = 8192
}
# Outputs
output "infrastructure" {
value = {
dns_master = {
vmid = module.dns_master.vmid
name = module.dns_master.vm_name
ip = module.dns_master.vm_ip
dns = module.dns_master.vm_dns
}
ansible = {
vmid = module.ansible_controller.vmid
name = module.ansible_controller.vm_name
ip = module.ansible_controller.vm_ip
dns = module.ansible_controller.vm_dns
}
}
}
output "tenant_001" {
value = {
web = module.tenant001_web
api = module.tenant001_api
db = module.tenant001_db
}
}
# ==============================================================================
# 9. Variables Terraform
# ==============================================================================
# variables.tf
variable "member_id" {
description = "ID du membre de L'Alliance Boréale"
type = string
validation {
condition = can(regex("^[a-z]{2,4}$", var.member_id))
error_message = "member_id doit être 2-4 lettres minuscules."
}
}
variable "proxmox_node" {
description = "Nœud Proxmox cible"
type = string
default = "pve1"
}
variable "dns_domain" {
description = "Domaine DNS de L'Alliance"
type = string
default = "alliance-boreale.ca"
}
variable "vm_template" {
description = "Template VM par défaut"
type = string
default = "debian-12-template"
}
# ==============================================================================
# 10. Makefile pour Automatisation
# ==============================================================================
# Makefile
.PHONY: help audit migrate plan apply destroy
help:
@echo "Commandes disponibles:"
@echo " make audit - Audit de conformité"
@echo " make plan - Plan Terraform"
@echo " make apply - Appliquer Terraform"
@echo " make destroy - Détruire infrastructure Terraform"
@echo " make ansible - Exécuter playbooks Ansible"
audit:
@echo "=== Audit Nomenclature v2.0 ==="
audit-nomenclature.sh
ansible-playbook playbooks/audit-nomenclature-ansible.yml
plan:
terraform plan -out=tfplan
apply:
terraform apply tfplan
destroy:
terraform destroy
ansible:
ansible-playbook playbooks/configure-all.yml -i inventory/proxmox.yml
# ==============================================================================
# FIN DES TEMPLATES
# ==============================================================================
vars:
member_id: "{{ lookup('env', 'MEMBER_ID') | default('czp', true) }}"
# Calcul VMID
vmid: "{{ '0%s%02d%02d' | format(vm_layer, vm_type|int, vm_instance|int) }}"
# Construction nom VM
vm_name: "{{ member_id }}-infra-{{ vm_service_name }}-{{ vm_environment }}-{{ '%02d' | format(vm_instance|int) }}"
# Calcul IP selon couche
vm_ip: >-
{{
('10.0.0.' if vm_layer == '1' else
'10.0.1.' if vm_layer == '4' else
'10.0.2.' if vm_layer == '2' else
'10.0.3.') + (vm_type|int * 10 + vm_instance|int)|string
}}
# DNS
vm_dns: "{{ vm_service_name }}.infra.{{ member_id }}.alliance-boreale.ca"
tasks:
- name: Afficher plan de création
debug:
msg:
- "VMID: {{ vmid }}"
- "Nom: {{ vm_name }}"
- "IP: {{ vm_ip }}/24"
- "DNS: {{ vm_dns }}"
- name: Confirmer création
pause:
prompt: "Créer cette VM? (Ctrl+C pour annuler, Entrée pour continuer)"
- name: Créer VM dans Proxmox
community.general.proxmox_kvm:
api_host: "{{ proxmox_host }}"
api_user: "{{ proxmox_user }}"
api_password: "{{ proxmox_password }}"
node: "{{ proxmox_node }}"
vmid: "{{ vmid }}"
name: "{{ vm_name }}"
clone: "debian-12-template"
full: yes
cores: 2
memory: 2048
net:
net0: "virtio,bridge=vmbr0,tag={{ '2' if vm_layer == '2' else '1' }}"
ipconfig:
ipconfig0: "ip={{ vm_ip }}/24,gw=10.0.0.1"
tags:
- infrastructure
- "layer-{{ vm_layer }}"
- "{{ vm_environment }}"
- "service-{{ vm_service_name }}"
state: present
register: vm_created
- name: Démarrer la VM
community.general.proxmox_kvm:
api_host: "{{ proxmox_host }}"
api_user: "{{ proxmox_user }}"
api_password: "{{ proxmox_password }}"
vmid: "{{ vmid }}"
state: started
- name: Créer entrée DNS
ansible.builtin.lineinfile:
path: "/var/lib/alliance-boreale/dns-records.zone"
line: "{{ vm_dns }}. IN A {{ vm_ip }}"
create: yes
delegate_to: "{{ dns_master_host }}"
- name: Ajouter au monitoring
ansible.builtin.template:
src: templates/icinga2-host.conf.j2
dest: "/etc/icinga2/conf.d/hosts/{{ vm_name }}.conf"
delegate_to: "{{ monitoring_host }}"
notify: Reload Icinga2
# ==============================================================================
# 3. Playbook de Création VM Tenant
# ==============================================================================
# playbooks/create-tenant-vm.yml
---
- name: Créer VM Tenant selon nomenclature v2.0
hosts: localhost
gather_facts: no
vars_prompt:
- name: tenant_id
prompt: "Tenant ID (001-999)"
private: no
- name: vm_instance
prompt: "Instance (01-99)"
private: no
- name: vm_service_type
prompt: "Type (web/api/db/cache/worker)"
private: no
- name: vm_environment
prompt: "Environnement (prod/stg/dev