Mises à jour et retour arrière
Chaque mise à jour de la branche configurée redéploie l'instance. Cette page décrit ce qui se passe pendant un déploiement, la règle qui rend le retour arrière possible, et les critères pour décider de déployer ou non.
Qui peut le faire : l'exploitant.
Séquence d'un déploiement#
- Construction de l'image avec le commit source, et de l'image PostgreSQL si elle a changé.
postgressain, puisredissain.release: une seule release à la fois, migrations sous verrou, droits du rôle runtime revérifiés. Elle écrit la lignerelease_completedavec le commit, les migrations appliquées et le total. Elle inscritoperations.migrateau journal des actions.- Recréation du
worker: l'ancien reçoitSIGTERM, termine ses travaux et s'arrête parworker_drained. Puis recréation duweb. - Le nouveau worker écrit son battement. Sa sonde devient saine.
/readyzrepasse à 200.
Si la release échoue (release_failed), le web et le worker de la nouvelle version ne démarrent pas.
Règle des migrations additives#
Pendant l'étape 3, l'ancien web et l'ancien worker tournent encore sur le nouveau schéma. Une migration doit donc rester additive : nouvelle table, nouvelle colonne facultative, nouvel index.
Une suppression ou un renommage se fait en deux livraisons :
- la première cesse d'utiliser l'élément ;
- la suivante le retire.
Cette règle garantit aussi le retour arrière décrit ci-dessous.
Revenir à la version précédente#
- Dans Coolify, ouvrez Deployments, choisissez le déploiement réussi précédent et cliquez sur Redeploy. Vous pouvez aussi remettre la branche sur le commit précédent.
- La release de l'ancienne image constate des migrations plus récentes qu'elle ne connaît pas. Elle ne les annule pas et n'applique rien.
- L'ancien web et l'ancien worker démarrent sur le schéma courant, grâce à la règle additive.
Le Compose ne permet pas de revenir à une version antérieure au premier déploiement de l'instance.
Critères GO#
Déployez si toutes les conditions sont réunies :
- La CI est verte sur le commit à déployer.
- Toute nouvelle migration est additive, ou la livraison en deux temps est documentée.
- Une sauvegarde de moins de 24 heures existe, avec des empreintes valides.
- Un essai de restauration a réussi au cours des 30 derniers jours.
- Les secrets sont présents dans Coolify et dans le coffre, et aucun n'apparaît dans les journaux.
- Après déploiement,
release_completedaffiche le commit attendu etruntimePrivileges: "verified". webetworkersont healthy,/healthzrépond 200,/readyzrépond 200 avec"unavailable": [].- Le dernier arrêt du worker s'est terminé par
worker_drained(code 0). - PostgreSQL et Redis n'ont aucun port publié ni domaine.
- Aucune alerte critique n'est ouverte sur la page Exploitation ni dans
maintain_alert_open.
Critères NO-GO#
Ne déployez pas, ou revenez immédiatement à la version précédente, dans l'un de ces cas :
release_failed, ou web et worker bloqués en attente de la release./readyzencore en 503 cinq minutes après le déploiement, ou capacitédatabaseindisponible.- Sonde du worker en échec, ou arrêt du worker en code 137 (délai de grâce dépassé).
- Un secret visible dans un journal, une image ou une archive.
- Sauvegarde absente ou empreintes invalides avant une migration.
- Commit déployé différent du commit attendu.
- Alerte Journal d'audit indisponible ou Disque ou base saturés ouverte après le déploiement.
Vérifier le commit déployé#
Le commit affiché par Coolify, le label de l'image et la ligne release_completed doivent concorder :
docker inspect --format '{{index .Config.Labels "org.opencontainers.image.revision"}}' <conteneur-web>Changer un mot de passe de rôle PostgreSQL#
Modifier seulement la variable ne change pas le rôle existant. Changez d'abord le mot de passe dans la base, puis la variable, puis redéployez :
docker exec -it <conteneur-postgres> psql -U postgres -d maintain -c '\password maintain_runtime'Pour continuer#
Gérez la durée de conservation du journal avec Rétention du journal et rôles PostgreSQL.