Wiki
Stockage & GC
Tableau de bord de stockage par dépôt (taille, déduplication, croissance) et garbage collection : purge des vieilles révisions, chunks orphelins, phantom files.
Introduction
L'onglet Stockage montre l'occupation disque d'un dépôt et fournit un outil de garbage collection (GC) pour récupérer de l'espace en purgeant les vieilles révisions et les données devenues inutiles.
Accès et rôles
Accessible au super admin et au project_admin sur les dépôts qu'il administre, y compris le lancement du GC. Les statistiques serveur globales et la licence sont, elles, réservées au super admin (ailleurs dans le panneau).
Les métriques
- Taille totale et taille compressée.
- Ratio de déduplication (%) : la part d'espace économisée par le partage de chunks et la compression.
- Fichiers / révisions / chunks.
- Croissance (30 derniers jours) : histogramme des révisions par jour.
- Plus gros fichiers : le top 20 par taille, avec leur nombre de révisions.
Ces chiffres aident à repérer un dépôt qui gonfle : un fichier binaire volumineux souvent re-committé, ou une croissance anormale sur les 30 jours.
Garbage collection
Le GC purge l'historique ancien selon deux paramètres :
| Paramètre | Défaut | Rôle |
|---|---|---|
| Retention (days) | 90 | Âge en dessous duquel une révision est toujours conservée. |
| Min revisions to keep | 5 | Nombre de révisions récentes conservées par fichier, quel que soit leur âge. |
Deux boutons :
- Preview : simule sans rien supprimer. Bandeau : « X révisions seraient supprimées sur Y fichiers, Z entrées fantômes seraient retirées ». Toujours prévisualiser d'abord.
- Run GC : exécute réellement. Bandeau : « X révisions supprimées, Y chunks orphelins nettoyés, Z entrées fantômes retirées ». L'exécution est journalisée dans l'audit.
Ce que GC supprime
- Vieilles révisions : celles plus anciennes que Retention (days) ET au-delà des Min revisions to keep plus récentes par fichier. Puis leurs chunks, s'ils ne sont plus référencés par aucune autre révision.
- Chunks orphelins : les blocs de données que plus aucune révision n'utilise après la purge.
- Phantom files : des lignes de fichier jamais réellement committées (chemin invalide ou entrée restée en suspens), au-delà d'une fenêtre fixe de 7 jours (non configurable).
Les marqueurs de suppression (tombstones) des fichiers effacés ou obliterés sont épargnés : ils servent à propager la suppression aux clients lors de la sync, et ne doivent donc pas disparaître.
Pièges courants
Le Preview annonce peu de choses
Normal si le dépôt est récent ou si l'historique tient dans la rétention. Le GC ne touche qu'aux révisions à la fois assez vieilles et au-delà des N dernières par fichier.
Preview et Run n'affichent pas les mêmes compteurs
Le Preview ne peut pas prédire le nombre exact de chunks et de liens révision-chunk supprimés : il ne rapporte que les révisions, les fichiers scannés et les entrées fantômes. Les chunks orphelins n'apparaissent qu'au Run.
Baisser la rétention pour récupérer de l'espace
Possible, mais vous perdez de l'historique. Sur un projet où l'on doit pouvoir revenir loin en arrière, gardez une rétention confortable et jouez plutôt sur les gros fichiers (voir la liste des plus gros fichiers, et le .uversionignore pour éviter de tracker des artefacts régénérables).