Mettre à jour QuoteNode

QuoteNode vérifie automatiquement la disponibilité de nouvelles versions. Lorsqu’une version plus récente est disponible, le panneau d’administration affiche une notification indiquant le libellé de la version et un lien vers les notes de publication.

Mise à niveau vers PostgreSQL 18

Les fichiers Compose ci-dessus utilisent déjà postgres:18-alpine, donc les nouvelles installations n’ont rien à faire. Si vous avez utilisé une alpha antérieure sur PostgreSQL 16 ou 17, migrez les données une fois : un serveur PostgreSQL 18 ne démarre pas sur un répertoire de données plus ancien (l’application refuse de démarrer tant que les données ne sont pas compatibles, et ne les modifie jamais automatiquement). Utilisez la sauvegarde pg_dump de la checklist ci-dessous, recréez le volume de base de données sur postgres:18-alpine et restaurez le dump.

Fonctionnement des vérifications de version

Le frontend interroge https://quotenode.dev/releases/latest.json lors de la connexion à l’administration. Il s’agit d’une requête GET en lecture seule, non authentifiée. Aucune donnée de votre instance n’est transmise. La vérification peut être désactivée :

VITE_RELEASE_CHECK_ENABLED=false

Vous pouvez également remplacer l’URL du manifeste :

VITE_RELEASE_MANIFEST_URL=https://your-mirror.example.com/releases/latest.json

Si le manifeste est inaccessible, la vérification échoue silencieusement et le panneau d’administration fonctionne normalement.

Liste de contrôle avant la mise à jour

Avant de procéder à la mise à jour :

1. Notez la version actuelle visible dans Admin > Licence ou dans la notification de version.
2. Sauvegardez .env — ce fichier contient des secrets qui ne peuvent pas être régénérés (en particulier DB_ENCRYPTION_KEY).
3. Effectuez une sauvegarde de la base de données :

docker compose exec postgres pg_dump -U quotenode quotenode > backup-before-upgrade.sql

4. Si les sauvegardes automatiques sont activées (BACKUP_ENABLED=true), vérifiez qu’une sauvegarde récente existe dans le volume de sauvegarde.

Procédure de mise à jour

Pour les déploiements Docker Compose (VPS Ubuntu, Linux local, Coolify manuel) :

docker compose pull
docker compose up -d

Cette commande télécharge les dernières images et recrée uniquement les conteneurs dont les images ont changé. Les migrations de base de données s’exécutent automatiquement au démarrage du backend.

Pour Coolify avec le déploiement automatique activé, une poussée vers la branche configurée déclenche automatiquement la mise à jour.

Vérification après la mise à jour

Une fois les conteneurs en cours d’exécution :

1. Ouvrez /health — doit retourner UP.
2. Connectez-vous et vérifiez le nouveau numéro de version dans Admin > Licence.
3. Créez une offre test et générez un PDF pour vérifier que le pipeline fonctionne.
4. Ouvrez un lien public pour vérifier le routage frontend.
5. Si SMTP est configuré, vérifiez qu’un e-mail de notification test est bien envoyé.

Retour arrière

Si la mise à jour cause des problèmes :

1. N’exécutez pas docker compose down -v — cette commande supprime toutes les données, y compris la base de données.
2. Arrêtez les services :

docker compose down

3. Modifiez docker-compose.yml (ou .env) pour épingler les étiquettes d’image précédentes :

services:
  backend:
    image: ghcr.io/lesisty7/quotenode/quotenode-api:v0.9.0-alpha
  frontend:
    image: ghcr.io/lesisty7/quotenode/quotenode-frontend:v0.9.0-alpha

4. Redémarrez :

docker compose up -d

Si la nouvelle version incluait des migrations de base de données irréversibles, revenir aux images précédentes seules peut ne pas suffire. Dans ce cas, restaurez la base de données depuis votre sauvegarde pré-mise à jour :

docker compose down
docker compose up -d postgres
docker compose exec -T postgres psql -U quotenode quotenode < backup-before-upgrade.sql
docker compose up -d

Épinglage des étiquettes d’image

Les guides d’installation utilisent les étiquettes latest par souci de simplicité. Pour les déploiements en production, épinglez des étiquettes de version explicites afin de contrôler le moment des mises à jour :

services:
  backend:
    image: ghcr.io/lesisty7/quotenode/quotenode-api:v0.9.0-beta
  frontend:
    image: ghcr.io/lesisty7/quotenode/quotenode-frontend:v0.9.0-beta

Effectuez ensuite la mise à jour en modifiant l’étiquette et en exécutant docker compose up -d.

Format de version

QuoteNode utilise la gestion sémantique des versions avec un suffixe de canal :

• v0.9.0-alpha — développement précoce
• v0.9.0-beta — bêta publique
• v0.9.0-rc — version candidate
• v0.9.0 — version stable

Le manifeste de version inclut version, channel, label et imageTags afin que le frontend puisse comparer les versions avec précision.