From e2087a2e32cea29bf088e03a256639b583441121 Mon Sep 17 00:00:00 2001 From: youness-adm Date: Mon, 27 Apr 2026 02:39:37 +0200 Subject: [PATCH] Ajouter README.md --- README.md | 91 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..1cf1eea --- /dev/null +++ b/README.md @@ -0,0 +1,91 @@ +# ephaitek-provisioning + +> Automatisation complète du provisioning et post-provisioning de VMs Rocky Linux 9 sur l'infrastructure Ephaitek. + +## Vue d'ensemble + +Ce dépôt contient les scripts pour déployer une nouvelle VM de zéro jusqu'à son intégration complète dans l'écosystème Ephaitek : pfSense, DNS split, PKI Vault, SSSD/LDAP. + +``` +┌─────────────────────────────┐ +│ INFRA (Proxmox) │ +│ ./deploy-vm.sh │ ← Crée et démarre la VM +└────────────┬────────────────┘ + │ VM démarrée + ▼ +┌─────────────────────────────┐ +│ ADMIN (10.100.0.10) │ +│ ./run-all.sh │ ← Post-provisioning complet +│ ├── 01-pfsense.sh │ VLAN + FW +│ ├── 02-dns.sh │ Enregistrements DNS +│ ├── 03-pki.sh │ CA cert Vault +│ ├── 04-splitdns.sh │ dnsmasq split DNS +│ └── 05-sssd.sh │ LDAP + PAM +└─────────────────────────────┘ +``` + +## Démarrage rapide + +### 1. Machine INFRA (Proxmox) + +```bash +./scripts/infra/deploy-vm.sh --vmid 1110 --name client1 --vlan 11 +``` + +### 2. Machine ADMIN + +```bash +export VM_ROOT_PASSWORD="Tyujkl46" +./scripts/admin/run-all.sh --vmid 1110 --name client1 --vlan 11 +``` + +C'est tout. Les deux commandes suffisent pour une VM complètement intégrée. + +## Convention d'adressage Ephaitek + +Tout l'adressage est dérivé automatiquement du `VLAN ID` : + +| Paramètre | Formule | Exemple VLAN 11 | +|--------------|----------------------|------------------| +| IP SVC | `10..0.10/24` | `10.11.0.10/24` | +| Gateway | `10..0.1` | `10.11.0.1` | +| IP Admin | `10.100.0.` | `10.100.0.11` | +| Port SSH | `22` | `2211` | +| FQDN SVC | `.svc.ephaitek.com` | `client1.svc.ephaitek.com` | +| FQDN ADM | `.adm.ephaitek.com` | `client1.adm.ephaitek.com` | + +## Structure du dépôt + +``` +ephaitek-provisioning/ +├── README.md ← Ce fichier +├── docs/ +│ ├── architecture.md ← Schémas et composants +│ ├── prerequisites.md ← Ce qu'il faut avant de commencer +│ ├── installation.md ← Installation pas à pas +│ ├── usage.md ← Guide d'utilisation complet +│ ├── troubleshooting.md ← Résolution des problèmes connus +│ └── security.md ← Bonnes pratiques sécurité +└── scripts/ + ├── infra/ + │ └── deploy-vm.sh ← Script INFRA (Proxmox) + └── admin/ + ├── run-all.sh ← Orchestrateur ADMIN + └── steps/ + ├── 01-pfsense.sh + ├── 02-dns.sh + ├── 03-pki.sh + ├── 04-splitdns.sh + └── 05-sssd.sh +``` + +## Documentation complète + +| Doc | Description | +|-----|-------------| +| [Architecture](docs/architecture.md) | Schéma réseau, composants, flux | +| [Prérequis](docs/prerequisites.md) | Dépendances, accès SSH, fichiers nécessaires | +| [Installation](docs/installation.md) | Mise en place du dépôt et configuration initiale | +| [Utilisation](docs/usage.md) | Toutes les options, exemples, vérifications | +| [Dépannage](docs/troubleshooting.md) | Problèmes connus et solutions | +| [Sécurité](docs/security.md) | Permissions, credentials, bonnes pratiques | \ No newline at end of file