# Gérer le registre d'images

> Consultez la place occupée par les images de votre application, activez la purge automatique des anciens builds et supprimez un build à la main.

Les images de vos builds s'accumulent dans le registre de l'application. Depuis la page **Builds**, vous suivez la place occupée, vous réglez la purge automatique et vous supprimez les builds dont vous n'avez plus besoin.

## Avant de commencer

- Lisez la règle de rétention : voir [Registre d'images et rétention](/v1.0/builds-et-deploiements/registre-et-retention).
- Les cartes **Registre** et **Purge automatique des builds** s'affichent avec le droit **Voir le stockage du registre** ; le réglage de la purge demande **Gérer la purge automatique des builds**.

## Consulter la place occupée

1. Dans le menu de l'application, cliquez sur **Builds**.
2. Lisez la carte **Registre** : « Place occupée par les images de l'app dans le registre. ».
   - Si un quota est fixé, une jauge indique la part utilisée.
   - « Pas encore relevé » signifie que la mesure, faite toutes les 15 minutes et après chaque build réussi, n'a pas encore eu lieu.

## Activer la purge automatique

1. Dans la carte **Purge automatique des builds**, activez **Purge automatique**.
2. Dans **Builds gardés par branche**, saisissez le nombre de builds à garder, entre 3 et 500. La valeur par défaut est 10.
3. Lisez l'aperçu sous le champ : « N images partiraient à la prochaine purge. ».
4. Cliquez sur **Enregistrer**.
5. Dans la fenêtre **Activer la purge automatique ?**, relisez le nombre d'images concernées, puis cliquez sur **Activer la purge**.

Résultat : le message « Réglages de purge enregistrés » s'affiche. La purge tourne la nuit suivante à 3 h 30 ; la carte affiche ensuite « Dernière purge : *date*, N image(s) supprimée(s) ».

Pour réduire ensuite la rétention, modifiez **Builds gardés par branche**, cliquez sur **Enregistrer**, puis confirmez dans la fenêtre **Ne garder que N builds par branche ?** avec **Confirmer**.

:::note[Purge en simulation]
Si la carte affiche « La purge tourne actuellement en simulation sur la plateforme : rien n'est supprimé pour l'instant. », vos réglages sont enregistrés mais aucune image n'est supprimée. La carte indique combien d'images l'auraient été lors de la dernière simulation.
:::

## Supprimer un build

Supprimez un build pour qu'il n'apparaisse plus dans la liste ni dans les images proposées au déploiement.

1. Dans **Builds**, tableau **Historique des builds**, ouvrez le menu de la ligne et cliquez sur **Supprimer**.
2. Dans la fenêtre **Supprimer ce build ?**, cliquez sur **Supprimer**.

Résultat : le message « Build supprimé » s'affiche et la ligne disparaît.

Un build ne peut pas être supprimé s'il est encore en cours, ou si son image tourne sur une instance de service : déployez d'abord une autre image sur ces instances. Le menu **Supprimer** est grisé pour un build en cours.

## Vérifier le résultat

- Après la purge de la nuit, la carte **Purge automatique des builds** affiche la date de la dernière purge et le nombre d'images supprimées.
- La place occupée diminue après le nettoyage hebdomadaire du registre, le dimanche.

## Dépannage

- « Quota atteint (100 %) : les nouveaux builds sont refusés tant que de la place n'aura pas été libérée » : activez la purge ou supprimez des builds, puis attendez le nettoyage du dimanche ; pour un relèvement du quota, contactez Wakastart.
- `Cannot delete build … it is currently deployed on N service instance(s)` : l'image est en service ; déployez une autre image sur les instances citées.
- « Action non autorisée » — « Vous n'avez pas le droit de supprimer un build. » : il vous manque le droit **Supprimer un build**.

## Voir aussi

- [Registre d'images et rétention](/v1.0/builds-et-deploiements/registre-et-retention)
- [Référence des builds et déploiements](/v1.0/builds-et-deploiements/reference)
