Index Complet de la Documentation Server Admin

Bienvenue !

Cette page liste toute la documentation server-admin disponible.

Choisis ton point de départ :

👶 Je suis débutant → Quickstart (ou README pour l’essentiel en 30 s)
🤔 Je veux comprendre l’architecture → Architecture
🚀 Je veux déployer → Déploiement
💾 J’ai besoin d’un backup / restore → Backup & Restore
🔴 Quelque chose ne marche pas → Dépannage
📚 Je veux les commandes exactes → Référence Commandes
➕ Je veux intégrer un nouveau projet → Ajouter un Nouveau Projet
➕ Gestion des credentials et vault → Secret et vault ansibles

Documentation Complète

Essentials (Lire en Premier)

Document Description

Document	Description
⚡ README	Point d’entrée — l’essentiel en 30 secondes
📖 Vue Générale	Rôles du projet, structure réelle du repo, concepts clés, bonnes pratiques
🏁 Quickstart (10 min)	Setup initial : clé SSH, vault, `make ping`, premier backup
🏗️ Architecture	Les 2 niveaux (orchestration + apps), les 5 repos Git, flux réels, ports
💻 Référence Commandes Make	LE plus important : les 6 commandes réelles et les 19 cibles de déploiement

⚡ README

Point d’entrée — l’essentiel en 30 secondes

📖 Vue Générale

Rôles du projet, structure réelle du repo, concepts clés, bonnes pratiques

🏁 Quickstart (10 min)

Setup initial : clé SSH, vault, make ping, premier backup

🏗️ Architecture

Les 2 niveaux (orchestration + apps), les 5 repos Git, flux réels, ports

💻 Référence Commandes Make

LE plus important : les 6 commandes réelles et les 19 cibles de déploiement

Opérations Quotidiennes

Document Description

Document	Description
🚀 Déploiement	Déroulement par type de cible, backups pre-deploy auto, rollback, Jenkins
💾 Backup & Restore	4 bases + MinIO, crons 3h/4h/5h, procédures de restauration, disaster recovery
🐳 Infrastructure Docker	Structure `include:`, 7 fichiers compose détaillés, réseau, conventions du parc
📊 Monitoring & Observabilité	Dozzle, Beszel, Loki+Promtail+Grafana, Kafka UI, RabbitMQ, RedisInsight

🚀 Déploiement

Déroulement par type de cible, backups pre-deploy auto, rollback, Jenkins

💾 Backup & Restore

4 bases + MinIO, crons 3h/4h/5h, procédures de restauration, disaster recovery

🐳 Infrastructure Docker

Structure include:, 7 fichiers compose détaillés, réseau, conventions du parc

📊 Monitoring & Observabilité

Dozzle, Beszel, Loki+Promtail+Grafana, Kafka UI, RabbitMQ, RedisInsight

Support & Évolution

Document	Description
🔴 Dépannage	Solutions aux problèmes réels (SSH, vault, deploy, DB, crons, disque, RAM) + recovery
➕ Ajouter un Nouveau Projet	Intégrer backend/frontend/PostgreSQL/MySQL/MongoDB/Redis au système Ansible

Document

Description

🔴 Dépannage

Solutions aux problèmes réels (SSH, vault, deploy, DB, crons, disque, RAM) + recovery

➕ Ajouter un Nouveau Projet

Intégrer backend/frontend/PostgreSQL/MySQL/MongoDB/Redis au système Ansible

Guides Futurs (Non Écrits)

Sujets candidats pour de prochaines versions : sécurité & vault avancé, tuning performance (RAM Lightsail), CI/CD Jenkins détaillé, runbook Semaphore/Rundeck.

Matrice d’Utilisation

Document	Débutant	DevOps	Développeur
Quickstart	✅ Essentiel	✅	✅
Architecture	✅	✅ Essentiel	⚠️
Commands Reference	✅	✅ Essentiel	✅ Essentiel
Deployment	⚠️	✅ Essentiel	✅
Backup & Restore	⚠️	✅ Essentiel	⚠️
Docker Infrastructure	⚠️	✅	⚠️
Monitoring	⚠️	✅	✅
Troubleshooting	✅	✅	✅
Adding New Projects		✅	✅

Document

Débutant

DevOps

Développeur

Quickstart

✅ Essentiel

✅

Architecture

✅

✅ Essentiel

⚠️

Commands Reference

✅

✅ Essentiel

Deployment

⚠️

✅ Essentiel

✅

Backup & Restore

⚠️

✅ Essentiel

⚠️

Docker Infrastructure

⚠️

✅

⚠️

Monitoring

⚠️

✅

Troubleshooting

✅

Adding New Projects

✅

Légende : ✅ = à lire, ⚠️ = utile, vide = optionnel

Parcours Recommandés

Nouveau Membre (Jour 1) — ~1h30

Quickstart (15 min) — setup + premier backup
Architecture (30 min) — comprendre les 2 niveaux et les flux
Commandes (20 min) — les 6 commandes et les 19 cibles
Déploiement (25 min) — savoir déployer en confiance

Avant une Opération Critique — ~30 min

Backup & Restore — vérifier les dumps récents, faire un backup manuel
Déploiement — checklist avant déploiement production
Dépannage — connaître le plan de repli (rollback, dump pre-deploy)

Pendant un Incident

Dépannage — méthode générale + cas par cas
Monitoring — Dozzle (live), Beszel (ressources), Grafana/Loki (historique)
Restore — si les données sont touchées

Rechercher dans la Documentation

# Chercher un mot-clé dans tous les documents
grep -rn "pre-deploy" doc/server-admin/
grep -rn "vault" doc/server-admin/
grep -rn "rollback" doc/server-admin/

Document Commandes couvertes Mots-clés

Document	Commandes couvertes	Mots-clés
quickstart.adoc	`make ping`, `make backup`	setup, ssh, vault, admin@18.158.207.98
commands-reference.adoc	les 6 cibles make + équivalents ansible-playbook	APP, TAG, BRANCH, ENV, DUMP, 19 cibles
deployment.adoc	`make deploy`	pre-deploy, rollback, deploy_frontend, Jenkins, Traefik
backup-restore.adoc	`make backup`, `make restore`, `make setup-cron`	pg_dump, mongodump, mc mirror, cron, dump_description
docker-infrastructure.adoc	`docker compose`	include, proxy_server_network, mem_limit, healthcheck
monitoring.adoc	—	Dozzle 9999, Beszel 8090, Grafana 3000, Loki, Kafka UI 8091
troubleshooting.adoc	diagnostics shell	publickey, vault password, OOM, disque, disaster recovery
adding-new-projects.adoc	intégration complète	vars.yml, vault.yml, assert, include_role, db_type

quickstart.adoc

make ping, make backup

setup, ssh, vault, admin@18.158.207.98

commands-reference.adoc

les 6 cibles make + équivalents ansible-playbook

APP, TAG, BRANCH, ENV, DUMP, 19 cibles

deployment.adoc

make deploy

pre-deploy, rollback, deploy_frontend, Jenkins, Traefik

backup-restore.adoc

make backup, make restore, make setup-cron

pg_dump, mongodump, mc mirror, cron, dump_description

docker-infrastructure.adoc

docker compose

include, proxy_server_network, mem_limit, healthcheck

monitoring.adoc

—

Dozzle 9999, Beszel 8090, Grafana 3000, Loki, Kafka UI 8091

troubleshooting.adoc

diagnostics shell

publickey, vault password, OOM, disque, disaster recovery

adding-new-projects.adoc

intégration complète

vars.yml, vault.yml, assert, include_role, db_type

Support

Consulter Dépannage — la plupart des cas y sont
Vérifier le code (source de vérité) : Makefile, ansible/playbooks/, docker-compose*.yml
Le README.md et CLAUDE.md du repo sever-admin contiennent la documentation d’origine du mainteneur

Contribuer : cette doc vit dans le repo documentation — corriger, commiter, pousser.

Version : 2.0 (2026-07-26) — réécriture complète alignée fichier par fichier sur le repo réel