Déploiement — Guide Réel et Détaillé

Stack ClaraJob (repo clarajob_sa, compose à la racine) :
  clarajob-sa            stack complet (git pull + pull 4 images + up -d tout)
  clarajob-ddl           PostgreSQL (git pull sous-repo + restart) [backup pre-deploy auto]
  clarajob-mongo         MongoDB (restart)                          [backup pre-deploy auto]
  clarajob-front-api     API Spring Boot (restart, image GitLab)
  clarajob-front-gui     Vue.js (git pull + npm build OU pull image + restart nginx)
  clarajob-embedding     FastAPI embedding (restart)
  clarajob-redis         Redis (restart)
  minio-service          MinIO S3 (restart)
  minio-backup           Sidecar backup MinIO mc mirror (restart)
  dozzle                 Dozzle logs (restart)

Stack PredictX (repo marketisia, compose docker/docker-compose.yml) :
  marketisia-sa          stack complet                              [backup pre-deploy auto]
  marketisia-front-api   API seule (restart)
  marketisia-front-gui   GUI seule (restart)

Auth (repo auth-server) :
  auth-server-db         PostgreSQL Keycloak (restart)              [backup pre-deploy auto]
  keycloak               Keycloak (restart)                         [backup DB pre-deploy auto]

Infra (repo sever-admin) :
  adminer                Adminer (restart)
  server-admin-doc       Nginx documentation sever-admin (restart)

Documentation projets (repo documentation) :
  documentation          Site AsciiDoc (git pull, build/ versionné + restart nginx)

Proxy (repo main-server-proxy) :
  traefik                Traefik (git pull + restart, TAG optionnel)

make deploy APP=clarajob-sa                          # stack complet, images latest
make deploy APP=clarajob-sa TAG=v1.2.0               # version taguée
make deploy APP=clarajob-front-api TAG=abc1234       # commit SHA
make deploy APP=clarajob-ddl BRANCH=feature/my-branch
make deploy APP=clarajob-sa BRANCH=develop TAG=v1.2.0
make deploy APP=traefik TAG=v1.0.0
make deploy APP=documentation                        # pull (build/ versionné) + restart nginx
make deploy APP=clarajob-sa ENV=local

# 0. État des lieux
make ping                                        # connexion OK ?

# 1. Backup manuel de sécurité (en plus du pre-deploy auto)
make backup APP=clarajob-ddl
make backup APP=clarajob-mongo

# 2. Déploiement
make deploy APP=clarajob-sa TAG=v1.2.0

# 3. Vérification (le playbook affiche déjà les containers actifs)
ssh -i ~/.ssh/serverAdminSSHKeypair.pem admin@18.158.207.98
docker ps                                        # tous les containers Up ?
docker logs clarajob-front-api --tail 50         # pas d'erreurs au démarrage ?
exit

# 4. Vérification fonctionnelle via les UIs
#    Dozzle  (port 9999)  : logs temps réel
#    Beszel  (port 8090)  : CPU/RAM des containers
#    Grafana (port 3000)  : logs Loki centralisés

# Revenir à la version précédente de l'API
make deploy APP=clarajob-front-api TAG=v1.1.9

# Si la DB a été corrompue par une migration : restaurer le dump pre-deploy
# (créé automatiquement juste avant le déploiement)
ssh -i ~/.ssh/serverAdminSSHKeypair.pem admin@18.158.207.98 \
  "ls -lht /home/admin/app/sever-admin/db-config/dump/clarajob-ddl/ | head -5"
make restore APP=clarajob-ddl DUMP=clarajob-ddl-2026-07-26_141502.sql

Paramètres :
  TARGET_APP  : clarajob-sa | marketisia-sa   (choix)
  SKIP_BACKUP : false par défaut (déconseillé de le passer à true en production)

Stages :
  1. Checkout
  2. Backup pre-deploy  → ansible-playbook playbooks/backup.yml -e target_app=$TARGET_APP
  3. Deploy             → ansible-playbook playbooks/deploy.yml -e target_app=$TARGET_APP

Prérequis Jenkins :
  - Credential "Secret file" nommé VAULT_PASSWORD_FILE (contenu du .vault_password)
  - Ansible installé sur l'agent
  - Clé SSH du serveur dans le known_hosts de l'agent

□ make ping OK
□ Backup manuel des DBs concernées (make backup APP=...)
□ Les images existent dans le GitLab Registry avec le bon TAG (pipeline CI vert —
  voir « Prérequis — Création des Images Docker »)
□ Équipe prévenue (surtout pour clarajob-sa / marketisia-sa / traefik : restart complet)
□ Dozzle/Beszel ouverts pour surveiller pendant/après
□ Plan de repli connu : TAG précédent + nom du dump pre-deploy

# Lister tous les tags (simple)
git tag

# Lister les tags avec un motif
git tag -l "v1.*"

# Lister les tags avec plus de détails (commit SHA, date, message)
git tag -n1    # 1 ligne d'annotation
git tag -n5    # 5 lignes d'annotation

# Lister avec le commit associé
git tag -l --format='%(refname:short) %(objectname:short) %(creatordate:short)'

# Lister les tags triés par version (le plus récent en dernier)
git tag --sort=-version:refname

# Voir le tag le plus récent
git describe --tags --abbrev=0

# Voir tous les tags avec leur type (lightweight vs annotated)
git tag -l -n0 && git for-each-ref --sort=-version:refname --format='%(refname:short) %(objecttype)' refs/tags

# Sur le commit actuel
git tag v1.0.0

# Sur un commit spécifique
git tag v1.0.0 abc1234

# Pousser un seul tag
git push origin v1.0.0

# Pousser les commits ET les tags en une seule commande
git push origin --follow-tags

#Pousser une branche + ses tags
git push origin main --follow-tags

# Supprimer un tag local
git tag -d v1.0.0

# Ou avec --delete
git tag --delete v1.0.0

# 1. Supprimer localement
git tag -d v1.0.0

# 2. Pousser la suppression vers GitLab
git push origin --delete v1.0.0

set -a
while IFS= read -r f; do
  [ -f "$f" ] && source "$f"
done < <(find /media/multi2/projects/app/security/env -name '.env*.local' -type f 2>/dev/null | sort)
set +a