Ajouter un Nouveau Projet au Système Ansible

1. Préparer le docker-compose du projet (conventions du parc)
2. Déclarer les variables dans ansible/inventory/group_vars/all/vars.yml
3. Ajouter les secrets dans vault.yml (ansible-vault edit)
4. Ajouter la cible dans playbooks/deploy.yml (assert + task)
5. (si base de données) Ajouter aux playbooks backup.yml, restore.yml, setup-cron.yml
6. Tester : ENV=local → syntax-check → déploiement réel

# monapp/docker-compose.yml
networks:
  proxy_server_network:
    external: true                    # ① réseau partagé, JAMAIS créé par le compose

volumes:
  monapp-db-data:                     # ② volume nommé pour toute donnée persistante

services:
  monapp-ddl:                         # ③ nom de service = nom de container = identifiant unique
    image: postgres:16-alpine
    container_name: monapp-ddl        #    dans tout le parc (préfixe par le nom du projet)
    restart: unless-stopped           # ④ redémarrage auto
    environment:
      POSTGRES_DB: ${MONAPP_DB_NAME}          # ⑤ secrets via variables d'env (.env local
      POSTGRES_USER: ${MONAPP_DB_USER}        #    sur le serveur, vault côté Ansible)
      POSTGRES_PASSWORD: ${MONAPP_DB_PASS}
    volumes:
      - monapp-db-data:/var/lib/postgresql/data
    networks:
      - proxy_server_network
    mem_limit: 256m                   # ⑥ limite RAM OBLIGATOIRE (Lightsail = RAM limitée)
    memswap_limit: 256m
    healthcheck:                      # ⑦ healthcheck sur les services critiques
      test: ["CMD-SHELL", "pg_isready -U ${MONAPP_DB_USER} -d ${MONAPP_DB_NAME}"]
      interval: 10s
      timeout: 5s
      retries: 5

  monapp-api:
    image: registry.gitlab.com/app81724/monapp/monapp-api:${IMAGE_TAG:-latest}   # ⑧ tag paramétré
    container_name: monapp-api
    restart: unless-stopped
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://monapp-ddl:5432/${MONAPP_DB_NAME}  # ⑨ hostname
      SPRING_DATASOURCE_USERNAME: ${MONAPP_DB_USER}                               #    = nom du
      SPRING_DATASOURCE_PASSWORD: ${MONAPP_DB_PASS}                               #    container
    depends_on:
      monapp-ddl:
        condition: service_healthy
    networks:
      - proxy_server_network
    mem_limit: 512m
    memswap_limit: 512m
    labels:                           # ⑩ exposition publique via Traefik (pas de port publié)
      - "traefik.enable=true"
      - "traefik.http.routers.monapp.rule=Host(`monapp.mondomaine.com`)"
      - "traefik.http.routers.monapp.entrypoints=websecure"

# MonApp — description courte (repo principal, docker-compose.yml à la racine)
monapp_project_dir: "/home/admin/app/monapp"
monapp_git_url: "git@gitlab.com:app81724/monapp.git"

# Services applicatifs
monapp_api_service: "monapp-api"

# Base PostgreSQL
monapp_db_service: "monapp-ddl"
monapp_db_name: "{{ vault_monapp_db_name }}"
monapp_db_user: "{{ vault_monapp_db_user }}"
monapp_db_pass: "{{ vault_monapp_db_pass }}"

cd sever-admin/ansible
ansible-vault edit inventory/group_vars/all/vault.yml
# (le mot de passe est lu automatiquement depuis ~/.vault_sever_admin via ansible.cfg)

vault_monapp_db_name: "monappdb"
vault_monapp_db_user: "monapp_user"
vault_monapp_db_pass: "MotDePasseFort"

cd sever-admin/ansible

# 1. Syntaxe
ansible-playbook --syntax-check playbooks/deploy.yml
ansible-playbook --syntax-check playbooks/backup.yml
ansible-playbook --syntax-check playbooks/restore.yml

# 2. Test en local (ta machine, si Docker dispo)
cd ..
make deploy APP=monapp-ddl ENV=local
make backup APP=monapp-ddl ENV=local
make restore APP=monapp-ddl ENV=local DUMP=<fichier-produit-au-2>

# 3. Production
make deploy APP=monapp-ddl          # la DB d'abord
make deploy APP=monapp-api          # puis l'API
make backup APP=monapp-ddl          # backup manuel de validation

# 4. Vérifier
ssh -i ~/.ssh/serverAdminSSHKeypair.pem admin@18.158.207.98
docker ps | grep monapp
docker logs monapp-api --tail 50
ls -lh /home/admin/app/sever-admin/db-config/dump/monapp-ddl/

Compose (repo du projet) :
□ networks: proxy_server_network (external: true)
□ container_name explicites et uniques dans le parc
□ ${IMAGE_TAG:-latest} sur les images GitLab
□ Secrets via ${VARS} (jamais en dur) + .env sur le serveur
□ mem_limit / memswap_limit sur chaque service
□ restart: unless-stopped + healthchecks
□ Volumes nommés pour les données
□ Labels Traefik si exposition publique

Ansible (sever-admin) :
□ vars.yml : bloc de variables préfixées (project_dir, git_url, *_service, db_*)
□ vault.yml : secrets vault_* ajoutés (ansible-vault edit)
□ deploy.yml : assert étendu + task(s) include_role
□ deploy.yml : backup pre-deploy si DB
□ backup.yml / restore.yml : blocs DB ajoutés
□ setup-cron.yml : cron quotidien à une heure libre + make setup-cron relancé
□ Makefile : commentaires d'usage mis à jour

Serveur :
□ Deploy key GitLab du serveur autorisée sur le nouveau repo
□ .env du projet créé sur le serveur (variables du compose)
□ CI du projet pushe bien les images taguées au registry

Validation :
□ ansible-playbook --syntax-check sur les 3 playbooks
□ Cycle complet ENV=local si possible
□ make deploy → docker ps → docker logs OK
□ make backup → dump non-vide dans db-config/dump/<service>/
□ make restore testé avec le dump produit
□ Documentation mise à jour (ce dossier + README du repo)