---
title: Mises à jour et retour arrière
description: Séquence d'un déploiement, règle des migrations additives, retour à la version précédente et critères GO ou NO-GO.
---

# 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

1. Construction de l'image avec le commit source, et de l'image PostgreSQL si elle a changé.
2. `postgres` sain, puis `redis` sain.
3. `release` : une seule release à la fois, migrations sous verrou, droits du rôle runtime revérifiés. Elle écrit la ligne `release_completed` avec le commit, les migrations appliquées et le total. Elle inscrit `operations.migrate` au journal des actions.
4. Recréation du `worker` : l'ancien reçoit `SIGTERM`, termine ses travaux et s'arrête par `worker_drained`. Puis recréation du `web`.
5. Le nouveau worker écrit son battement. Sa sonde devient saine.
6. `/readyz` repasse à 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 :

1. la première cesse d'utiliser l'élément ;
2. la suivante le retire.

Cette règle garantit aussi le retour arrière décrit ci-dessous.

## Revenir à la version précédente

1. 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.
2. 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.
3. L'ancien web et l'ancien worker démarrent sur le schéma courant, grâce à la règle additive.

> [!WARNING]
> N'exécutez jamais `migration:rollback` en production hors d'un plan d'incident écrit : cette commande peut détruire des données. Si une migration a abîmé des données, restaurez la dernière sauvegarde dans une pile neuve. Voir [Sauvegarde et restauration](08-sauvegarde-et-restauration.md).

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 :

1. La CI est verte sur le commit à déployer.
2. Toute nouvelle migration est additive, ou la livraison en deux temps est documentée.
3. Une sauvegarde de moins de 24 heures existe, avec des empreintes valides.
4. Un essai de restauration a réussi au cours des 30 derniers jours.
5. Les secrets sont présents dans Coolify et dans le coffre, et aucun n'apparaît dans les journaux.
6. Après déploiement, `release_completed` affiche le commit attendu et `runtimePrivileges: "verified"`.
7. `web` et `worker` sont *healthy*, `/healthz` répond 200, `/readyz` répond 200 avec `"unavailable": []`.
8. Le dernier arrêt du worker s'est terminé par `worker_drained` (code 0).
9. PostgreSQL et Redis n'ont aucun port publié ni domaine.
10. 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 :

1. `release_failed`, ou web et worker bloqués en attente de la release.
2. `/readyz` encore en 503 cinq minutes après le déploiement, ou capacité `database` indisponible.
3. Sonde du worker en échec, ou arrêt du worker en code 137 (délai de grâce dépassé).
4. Un secret visible dans un journal, une image ou une archive.
5. Sauvegarde absente ou empreintes invalides avant une migration.
6. Commit déployé différent du commit attendu.
7. 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 :

```bash
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 :

```bash
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](10-retention-et-roles-postgresql.md).
