La mise à jour est en échec

Symptôme

Vous lancez une mise à jour de Dokos. Elle s'arrête sur une erreur :

• sur Dokos Cloud, le déploiement du groupe de bench est en échec dans la console, avec un journal technique (par exemple une erreur pendant l'installation de Python) ;
• en auto-hébergement, bench update s'arrête et affiche une trace d'erreur Python ou une erreur de patch.

Cause

Les causes les plus fréquentes :

• un service externe est indisponible pendant la construction (dépôt de paquets, registre…). L'erreur disparaît quand le service revient ;
• un patch de migration échoue sur vos données ;
• une application personnalisée n'est pas compatible avec la nouvelle version ;
• en auto-hébergement, un dépôt git local a des modifications qui bloquent la récupération du code.

Résolution

Sur Dokos Cloud

1. Ouvrez le déploiement en échec dans la console et notez l'étape qui échoue.
2. Si l'erreur vient d'un service externe (téléchargement, dépôt de paquets), relancez le déploiement un peu plus tard.
3. Votre site reste sur l'ancienne version tant que le déploiement n'a pas réussi. Si le site est en récupération après une migration, ne relancez rien et suivez Résoudre un problème de site Cloud.
4. Si le même déploiement échoue deux fois, écrivez au support avec le lien du déploiement.

Un déploiement peut aussi être simplement long. Attendez sa fin avant de conclure à un blocage.

En auto-hébergement

1. Copiez le message d'erreur complet.
2. Si l'erreur est un conflit git, lancez bench update --reset --restart-supervisor.
3. Si un patch échoue, cherchez le message sur le forum, ou publiez-le avec vos versions. Attendez la correction, puis relancez bench update.
4. Si le site reste en mode maintenance, lancez bench --site <votre-site> set-maintenance-mode off.
5. Testez de nouveau sans vos applications personnalisées pour savoir si elles sont en cause.

Exemple

Dokompany planifie la mise à jour de son groupe de bench un vendredi soir. Le déploiement échoue pendant l'installation de Python, car le dépôt de paquets externe ne répond pas. Le lundi, l'administrateur relance le déploiement depuis la console. Il réussit, puis il met à jour dokompany-test.dokos.cloud avant la production.

Vérifier

• Le déploiement est terminé avec succès dans la console, ou bench update se termine sans erreur.
• Aide > À propos affiche les nouvelles versions de Dodock et de Dokos.

Pour aller plus loin

• Mettre à jour un site Dokos Cloud
• Mises à jour en auto-hébergement