# Registre d'images et rétention

> Où sont rangées les images de votre application, comment la purge automatique choisit celles à supprimer et ce qui est toujours protégé.

Chaque application a son propre espace dans le registre d'images de Wakastart. Toutes les images produites par ses builds y sont rangées, et y restent tant que personne ne les supprime. La purge automatique, que vous activez si vous le souhaitez, garde le registre à une taille raisonnable sans jamais retirer une image utile.

## Définition

Le [registre](/v1.0/glossaire#registre) est le stockage privé des images de conteneur de l'application. Seuls les environnements de l'application peuvent y télécharger des images.

La **rétention** est la règle qui décide quelles images garder. Elle compte les builds réussis **par branche** : avec une rétention de 10, Wakastart garde les 10 builds les plus récents de `main`, les 10 plus récents de `develop`, et ainsi de suite. Les builds lancés depuis un tag Git forment un groupe à part, de même que les builds lancés depuis un commit sans branche.

## Pourquoi ça existe

Un projet actif produit des dizaines d'images par semaine, de plusieurs centaines de mégaoctets chacune. Sans purge, le registre grossit indéfiniment. Mais une purge naïve — « garder les 10 dernières » — pourrait supprimer l'image qui tourne en production, ou celle vers laquelle vous voulez revenir. La règle de rétention protège ces images.

## Comment ça marche

### Ce qui est toujours conservé

Une image n'est jamais supprimée, quelle que soit la rétention, si :

- elle est déployée sur une instance de service, dans n'importe quel environnement ;
- elle a été déployée, ou remplacée par une autre, il y a moins de **90 jours** ;
- elle partage son tag avec une image conservée ;
- elle est utilisée par un conteneur en cours d'exécution, vérification faite au moment de la purge.

Les builds en échec ne sont pas concernés : ils n'ont pas d'image.

Dans la liste des builds, le badge **Déployé · prod, dev** signale une image en service, et le badge **Conservé** une image protégée de la purge.

### Quand la purge passe

La purge automatique tourne **chaque nuit à 3 h 30**, pour les applications qui l'ont activée. Elle supprime les images candidates du registre, puis retire les builds correspondants de la liste. Elle traite au plus 100 images par nuit pour toute la plateforme : un grand ménage peut s'étaler sur plusieurs nuits.

Quand la plateforme fait tourner la purge en simulation, rien n'est supprimé : la carte **Purge automatique des builds** l'indique et affiche le nombre d'images qui auraient été supprimées.

### La place occupée

La carte **Registre** affiche la place occupée par les images de l'application. Elle est mesurée toutes les 15 minutes et après chaque build réussi. Supprimer une image ne libère pas la place aussitôt : l'espace est récupéré au nettoyage hebdomadaire du registre, le dimanche.

### Le quota

Wakastart peut fixer un quota de stockage pour votre application. La carte **Registre** affiche alors une jauge. À 80 % du quota, un avertissement apparaît ; à 100 %, les nouveaux builds sont refusés jusqu'à ce que de la place soit libérée. Pour relever le quota, contactez Wakastart.

## Exemples

- **Petite équipe.** Rétention à 10 : chaque branche garde ses 10 dernières images, et l'image de production reste protégée même si elle date de 3 mois.
- **Beaucoup de branches de fonctionnalité.** Rétention à 3 : chaque branche éphémère ne garde que 3 images, et la purge libère la place des branches abandonnées.
- **Retour arrière.** L'image déployée en production la semaine dernière, puis remplacée, reste disponible 90 jours : vous pouvez y revenir à tout moment pendant cette période.

## Pour aller plus loin

- [Gérer le registre d'images](/v1.0/builds-et-deploiements/gerer-le-registre)
- [Revenir à une version précédente](/v1.0/builds-et-deploiements/revenir-a-une-version-precedente)
- [Référence des builds et déploiements](/v1.0/builds-et-deploiements/reference)
