Aller au contenu

Mises à jour et migrations

Une nouvelle version de KiwiDesk est publiée sous forme de nouvelles images Docker. La mettre en service revient à télécharger les images et à recréer les conteneurs ; la base de données est mise à niveau automatiquement au démarrage de l’API. Vos données, dans les volumes, ne bougent pas.

Chaque image est publiée avec plusieurs étiquettes :

Étiquette Signification
latest La dernière version de la branche principale.
1.2.0 Une version précise.
1.2 La dernière correction de la version 1.2.
sha-1a2b3c4 Un commit précis, utile pour revenir exactement à un état connu.

KIWIDESK_VERSION choisit l’étiquette. En production, préférez une version précise que vous changez quand vous le décidez, plutôt que latest.

  1. Choisir le moment : en dehors des heures d’ouverture. Clôturez les caisses (clôture Z) avant de commencer.

  2. Faire une sauvegarde juste avant, en lançant votre script de sauvegarde à la main (voir Sauvegarde et restauration).

  3. Changer la version dans .env (KIWIDESK_VERSION=1.3.0), ou laissez latest.

  4. Télécharger et redémarrer :

    Fenêtre de terminal
    docker compose -f docker-compose.yml pull
    docker compose -f docker-compose.yml up -d
  5. Suivre les migrations dans le journal de l’API :

    Fenêtre de terminal
    docker compose -f docker-compose.yml logs -f api

    Les lignes Applying database migrations... puis [seed] Done indiquent que la base est à jour. Le service web ne redémarre qu’une fois l’API déclarée en bonne santé.

  6. Vérifier dans Paramètres > À propos / Système que les versions Web et API sont identiques et que la Dernière migration a changé.

Au démarrage, le conteneur api exécute prisma migrate deploy : il applique, dans l’ordre, les migrations de la nouvelle version qui ne l’ont pas encore été. Puis, si KIWIDESK_SEED_ON_START=true, il ajoute les nouvelles données de départ (nouvelles permissions, nouveaux modèles de messages, réglages par défaut) sans toucher à ce que vous avez modifié.

Une migration interrompue (coupure de courant, disque plein) empêche l’API de démarrer : le journal indique la migration en cause. Restaurez la sauvegarde faite à l’étape 2, réglez la cause (espace disque, par exemple), puis relancez.

Les migrations ne se défont pas automatiquement. Pour revenir en arrière :

  1. Arrêtez la stack : docker compose -f docker-compose.yml down (les volumes sont conservés).
  2. Restaurez la sauvegarde prise juste avant la mise à jour.
  3. Remettez l’ancienne valeur de KIWIDESK_VERSION et relancez docker compose -f docker-compose.yml up -d.

Tout ce qui a été saisi depuis la mise à jour est alors perdu : décidez-en vite.

  • Le KiwiDesk Bridge des postes caisse a ses propres versions : voir Installer le Bridge.
  • L’image postgres:16-alpine reçoit les correctifs de PostgreSQL 16 avec un simple pull. Passer à une version majeure (17 et plus) demande un export et un import complets (pg_dump puis pg_restore dans une nouvelle base) : ne changez pas l’image sans cette procédure.