Ajouter README.md

This commit is contained in:
youness-adm committed 2026-04-27 02:39:37 +02:00
commit e2087a2e32
1 file changed
+91
+91
View File
@@ -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.<VLAN>.0.10/24` | `10.11.0.10/24` |
| Gateway | `10.<VLAN>.0.1` | `10.11.0.1` |
| IP Admin | `10.100.0.<VLAN>` | `10.100.0.11` |
| Port SSH | `22<VLAN>` | `2211` |
| FQDN SVC | `<nom>.svc.ephaitek.com` | `client1.svc.ephaitek.com` |
| FQDN ADM | `<nom>.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 |