Bienvenue ! Cette documentation couvre l’administration du projet sever-admin — orchestration Ansible (backup, restore, déploiement) et infrastructure Docker partagée pour ClaraJob-SA, Marketisia-SA / PredictX, auth-server (Keycloak) et Traefik, sur AWS Lightsail (Debian).

Par Où Commencer ?

Profil / Besoin Aller à

🆕 Nouveau sur le projet

Quickstart (10 min) puis Architecture

🚀 Je veux déployer

Déploiement + Référence Commandes

💾 Backup / Restauration

Backup & Restore

🔴 Quelque chose ne marche pas

Dépannage

➕ Intégrer un nouveau projet

Ajouter un Nouveau Projet

📚 Navigation complète

INDEX

Tous les Documents

Document Description

INDEX.adoc

Navigation complète et parcours de lecture recommandés

sever-admin.adoc

Vue d’ensemble : rôles du projet, structure réelle du repo, concepts clés

quickstart.adoc

Setup en 10 min : clé SSH, vault, make ping, premier backup

architecture.adoc

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

commands-reference.adoc

Les 6 commandes make (ping, backup, restore, deploy, setup-cron, help) et les 19 cibles de déploiement

deployment.adoc

Déroulement détaillé des déploiements, backups pre-deploy, rollback, Jenkins

backup-restore.adoc

Les 4 bases sauvegardées, crons 3h/4h/5h, MinIO, procédures de restore

docker-infrastructure.adoc

Structure include:, détail des 7 fichiers compose, réseau, conventions

monitoring.adoc

Dozzle, Beszel, Loki+Promtail+Grafana, Kafka UI, RedisInsight — quel outil pour quoi

troubleshooting.adoc

Solutions aux problèmes réels + plan de disaster recovery

adding-new-projects.adoc

Intégrer backend/frontend/DB/cache au système Ansible, étape par étape

L’Essentiel en 30 Secondes

# Setup (une fois)
cp infrastructure/security/serverAdminSSHKeypair.pem ~/.ssh/ && chmod 400 ~/.ssh/serverAdminSSHKeypair.pem
echo "MotDePasseVault" > ~/.vault_sever_admin && chmod 600 ~/.vault_sever_admin

# Les 6 commandes (il n'y en a pas d'autres)
make ping
make backup  APP=clarajob-ddl|clarajob-mongo|marketisia-sa|auth-server-db|all
make restore APP=<db> DUMP=<fichier>
make deploy  APP=<une-des-19-cibles> [TAG=v1.2.0] [BRANCH=develop]
make setup-cron
make help
# + ENV=local pour cibler ta machine

# Serveur : admin@18.158.207.98 (clé serverAdminSSHKeypair.pem)
# UIs : Dozzle 9999 · Beszel 8090 · Grafana 3000 · Semaphore 3001 ·
#       Adminer 9093 · pgAdmin 5050 · Kafka UI 8091 · RabbitMQ 15672 · Doc 8050

Liens Utiles

  • Repo : git@gitlab.com:app81724/sever-admin.git

  • Serveur : 18.158.207.98 — user admin — host Ansible vps-main

  • Registry : registry.gitlab.com (deploy token en vault)

  • Source de vérité : le code lui-même — Makefile, ansible/, docker-compose*.yml, README.md du repo

Maintenance de Cette Documentation

  • v2.0 (2026-07-26) — Réécriture complète alignée sur l’état réel du repo (Makefile, playbooks, rôles, compose files vérifiés fichier par fichier)

  • Guides futurs possibles : sécurité/vault avancé, tuning performance, CI/CD détaillé

  • Une divergence avec le code ? Le code fait foi — corriger la doc et proposer une MR