Infrastructure Ansible complète : VPN (Headscale), mots de passe (Vaultwarden), Docker UI (Portainer), sauvegardes (Zerobyte), monitoring (Uptime Kuma + Monit), collecteur de logs (Alloy), bot Telegram — le tout derrière Caddy avec SSL automatique.
Version : 3.0.0 · Février 2026 Public cible : Techniciens juniors & contributeurs Langue : Français Statut CI/CD : ✅ Pipeline validé (lint + 14 rôles Molecule + intégration Hetzner)
| # | Document | Description | Public |
|---|---|---|---|
| 1 | Architecture | Architecture système, réseau, services, flux de données | Tous |
| 2 | Guide de déploiement | Procédure pas-à-pas du premier déploiement à la production | Juniors |
| 3 | GitOps & CI/CD | Stratégie de branches, pipeline, workflows GitOps, bonnes pratiques | Tous |
| 4 | Référence des rôles | Les 14 rôles Ansible détaillés : variables, templates, dépendances | Contributeurs |
| 5 | Dépannage & Erreurs | Les 42 pièges documentés (Day 0 → CI/CD Round 5) | Juniors |
| 6 | Feuille de route V4 | Axes d'amélioration, priorisation, architecture cible V4 | Tous |
| 7 | Glossaire | Définitions des termes techniques utilisés dans le projet | Juniors |
Si tu es nouveau sur le projet :
- Commence par le Glossaire pour comprendre les termes
- Lis l'Architecture pour avoir une vue d'ensemble
- Suis le Guide de déploiement étape par étape
- Garde le Dépannage sous la main en cas d'erreur
Si tu veux contribuer au code :
- Lis GitOps & CI/CD pour comprendre le workflow de contribution
- Consulte la Référence des rôles pour le rôle que tu modifies
- Lance les tests localement avant de pusher (voir section Makefile)
Si tu planifies la V4 :
- Lis la Feuille de route V4 pour les axes prioritaires
14 rôles Ansible · 8 conteneurs Docker · 3 services natifs · 4 scripts
6 vhosts Caddy · 14 scénarios Molecule · Pipeline CI/CD 3 stages (validé)
~140 fichiers · 42 pièges documentés · ~40h de développement
| Ressource | Emplacement |
|---|---|
| README principal | ../README.md |
| Playbook principal | ../playbooks/site.yml |
| Wizard | ../scripts/wizard.sh |
| Pipeline CI | ../.github/workflows/ci.yml |
| Variables | ../inventory/group_vars/all/vars.yml |
| Secrets (chiffrés) | ../inventory/group_vars/all/vault.yml |