Qovans Docs
Operations

Demarrage et arret

Comment demarrer, arreter et verifier l'etat de chaque service Qovans.

Cette page explique comment gerer les services Qovans sur le VPS de production.

Connexion au serveur

ssh -i ~/.ssh/vps_qovans root@81.22.222.96
cd /opt/qovans

Demarrer tous les services

docker compose -f docker-compose.prod.yml up -d

Cette commande demarre PostgreSQL, MinIO, le backend et le frontend. PostgreSQL doit etre sain avant que le backend ne demarre (healthcheck configure).

Arreter tous les services

docker compose -f docker-compose.prod.yml down

Les donnees sont preservees dans les volumes Docker. Rien n'est perdu.

Verifier l'etat

# Voir les conteneurs en cours
docker compose -f docker-compose.prod.yml ps

# Resultat attendu :
# qovans-postgres   running (healthy)
# qovans-minio      running
# qovans-backend    running
# qovans-frontend   running

Redemarrer un seul service

# Redemarrer le backend uniquement
docker compose -f docker-compose.prod.yml restart backend

# Redemarrer le frontend uniquement
docker compose -f docker-compose.prod.yml restart frontend

Health checks

Deux endpoints permettent de verifier que l'application repond :

# Backend
curl http://localhost:8000/health
# Reponse attendue : {"status": "healthy", "environment": "production"}

# Test connexion Cegid
curl http://localhost:8000/api/test-cegid
# Reponse attendue : {"status": "success", "message": "Connexion Cegid OK"}

# Frontend
curl -s -o /dev/null -w "%{http_code}" http://localhost:3000
# Reponse attendue : 200

VPN Cegid

Le VPN est un service systemd sur le host, pas un conteneur Docker :

# Demarrer
sudo systemctl start openvpn-client@audaxium

# Verifier
sudo systemctl status openvpn-client@audaxium

# Tester la route vers Cegid
ping -c 2 192.168.4.110

Voir VPN Cegid pour le diagnostic detaille.

Ordre de demarrage apres un reboot

Apres un reboot du VPS, les services Docker redemarrent automatiquement (restart: unless-stopped). Mais le VPN doit etre demarre manuellement :

  1. Le VPN ne demarre pas automatiquement car la cle privee est chiffree
  2. Connectez-vous en SSH
  3. Demarrez le VPN : sudo systemctl start openvpn-client@audaxium
  4. Verifiez : curl http://localhost:8000/api/test-cegid

Si le VPN n'est pas demarre, le site fonctionne mais les stocks, prix en temps reel et la creation de commandes sont indisponibles.