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.
Comment les versions sont publiées
Section intitulée « Comment les versions sont publiées »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.
Mettre à jour
Section intitulée « Mettre à jour »-
Choisir le moment : en dehors des heures d’ouverture. Clôturez les caisses (clôture Z) avant de commencer.
-
Faire une sauvegarde juste avant, en lançant votre script de sauvegarde à la main (voir Sauvegarde et restauration).
-
Changer la version dans
.env(KIWIDESK_VERSION=1.3.0), ou laissezlatest. -
Télécharger et redémarrer :
Fenêtre de terminal docker compose -f docker-compose.yml pulldocker compose -f docker-compose.yml up -dOuvrez la stack, modifiez
KIWIDESK_VERSIONdans Environment variables si besoin, puis cliquez sur Update the stack en cochant Re-pull image and redeploy. -
Suivre les migrations dans le journal de l’API :
Fenêtre de terminal docker compose -f docker-compose.yml logs -f apiLes lignes
Applying database migrations...puis[seed] Doneindiquent que la base est à jour. Le servicewebne redémarre qu’une fois l’API déclarée en bonne santé. -
Vérifier dans Paramètres > À propos / Système que les versions Web et API sont identiques et que la Dernière migration a changé.
Ce que font les migrations
Section intitulée « Ce que font les migrations »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.
Revenir à la version précédente
Section intitulée « Revenir à la version précédente »Les migrations ne se défont pas automatiquement. Pour revenir en arrière :
- Arrêtez la stack :
docker compose -f docker-compose.yml down(les volumes sont conservés). - Restaurez la sauvegarde prise juste avant la mise à jour.
- Remettez l’ancienne valeur de
KIWIDESK_VERSIONet relancezdocker compose -f docker-compose.yml up -d.
Tout ce qui a été saisi depuis la mise à jour est alors perdu : décidez-en vite.
Mettre à jour le Bridge et la base PostgreSQL
Section intitulée « Mettre à jour le Bridge et la base PostgreSQL »- Le KiwiDesk Bridge des postes caisse a ses propres versions : voir Installer le Bridge.
- L’image
postgres:16-alpinereçoit les correctifs de PostgreSQL 16 avec un simplepull. Passer à une version majeure (17 et plus) demande un export et un import complets (pg_dumppuispg_restoredans une nouvelle base) : ne changez pas l’image sans cette procédure.