Mise en production

Ce guide décrit le déploiement de TrickSpin sur un VPS OVH avec Docker. L'architecture utilise Traefik comme reverse proxy pour gérer le routage et les certificats TLS (Let's Encrypt).

Architecture des services

Prérequis sur le VPS

Installer Docker

curl -fsSL https://get.docker.com | sh

Pointer le DNS vers le VPS

Avant de démarrer Traefik, créer les enregistrements DNS suivants chez OVH (zone DNS du domaine) :

Installation

1. Cloner le projet

git clone https://github.com/Charline-Heuguet/TrickSpin
cd TrickSpin

2. Variables d'environnement

cp .env.example .env

Éditer le fichier .env et renseigner toutes les valeurs :

nano .env

Variables base de données

Variables production

3. Lancer le build et démarrer

Sans Traefik (accès direct par ports, pour vérifier que tout fonctionne) :

make prod-build

Avec Traefik (configuration finale avec HTTPS et nom de domaine) :

docker compose --profile prod --profile traefik up -d --build

Le premier démarrage peut prendre quelques minutes : build des images, warmup du cache Symfony, et émission des certificats Let's Encrypt.

4. Initialiser les données

Une fois les conteneurs démarrés, lancer les migrations et importer les données métier :

# Migrations (lancées automatiquement au démarrage, mais vérifiable)
docker compose --profile prod exec back-prod php bin/console doctrine:migrations:status

# Importer les tricks depuis le CSV
docker compose --profile prod exec back-prod php bin/console app:import-tricks --no-interaction

# Importer les grabs
docker compose --profile prod exec back-prod php bin/console app:import-grabs --no-interaction

Commandes utiles en production

Mise à jour

Pour déployer une nouvelle version :

git pull
docker compose --profile prod --profile traefik up -d --build

Les migrations sont appliquées automatiquement au démarrage du conteneur via l'entrypoint.

Vérification

Pour vérifier les certificats TLS et l'état de Traefik :

docker compose --profile traefik logs traefik