Aller au contenu

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é.

ConceptDéveloppeurAdministrateur
Voir en Markdown

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 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