Une règle de nettoyage Artifact Registry définit des critères permettant de supprimer automatiquement les versions d'artefacts dont vous n'avez plus besoin ou de conserver les artefacts que vous souhaitez stocker indéfiniment.
Les règles de nettoyage sont utiles si vous stockez de nombreuses versions de vos artefacts, mais que vous n'avez besoin de conserver que celles que vous déployez en production. Vous pouvez définir des règles de suppression avec des critères de suppression des artefacts et des règles de conservation avec des critères de conservation des artefacts.
Les suppressions déclenchées par les règles de suppression sont comptabilisées dans votre quota de requêtes de suppression par projet Artifact Registry et sont limitées à 600 000 suppressions par dépôt et par jour.
Types de règles de nettoyage
Une règle de suppression définit l'âge minimal ou maximal pour la suppression des artefacts, avec des critères de filtrage supplémentaires disponibles pour limiter la règle à des artefacts spécifiques. Lorsque vous disposez d'une règle de suppression active, vous pouvez également configurer différents types de règles de conservation afin qu'Artifact Registry conserve des artefacts spécifiques :
- Règle de conservation conditionnelle : définit des critères de conservation des artefacts. Vous pouvez configurer des règles de conservation conditionnelles pour conserver les artefacts que vos règles de suppression supprimeraient autrement. Lorsqu'un artefact correspond aux critères d'une règle de suppression et d'une règle de conservation, il est conservé.
- Conserver les versions les plus récentes : définit des critères permettant de conserver une plage spécifique de versions d'artefacts. Vous ne pouvez pas utiliser les critères Conservation conditionnelle et Conserver les versions les plus récentes dans la même règle de nettoyage.
Priorité des règles correspondant à la même image
Si une version d'artefact correspond aux critères d'une règle de suppression et d'une règle de conservation, Artifact Registry applique la règle de conservation.
Si une version d'artefact correspond à plusieurs règles de suppression, Artifact Registry applique la règle de suppression avec la période de conservation la plus courte. Par exemple, vous disposez de deux règles de suppression :
- Règle de suppression 1 : supprime toutes les images dont les tags commencent par
commit-après 24 heures. - Règle de suppression 2 : supprime toutes les images taguées après sept jours.
Une image taguée commit-1234 correspond aux deux règles. Étant donné que la règle 1 a une période de conservation plus courte, l'image est supprimée après 24 heures.
Ordre d'application des règles
Si votre dépôt comporte plusieurs règles de nettoyage, Artifact Registry les applique dans l'ordre, sauf si une règle de conservation correspond à la même image qu'une règle de suppression. Par exemple, votre dépôt comporte des règles de nettoyage avec les conditions suivantes :
- Supprimer les images datant de plus de 100 jours.
- Conserver les images dont le préfixe de version est 2.0.6.
- Supprimer les images avec un tag
default.
Votre dépôt contient des images avec les attributs suivants :
| Image | Âge | Tag | Version |
|---|---|---|---|
| Image A | 120 jours | default |
2.0.1 |
| Image B | 150 jours | default |
2.0.6 |
| Image C | 20 jours | patch |
1.9.2 |
Dans cet exemple, l'image A est supprimée et l'image C est conservée. L'image B est également conservée en raison de la règle de conservation correspondant à la version de l'image, même si l'image B correspond également aux critères de suppression des première et troisième règles.
Calendrier d'application des règles
Artifact Registry effectue des dry runs et des exécutions actives des règles de nettoyage à l'aide d'une tâche en arrière-plan qui s'exécute régulièrement. Les modifications prennent effet sous un jour environ.
Nombre maximal de règles de nettoyage par dépôt
Vous pouvez appliquer un maximum de 10 règles de nettoyage à un dépôt.
Formats compatibles
Vous pouvez définir une règle de nettoyage sur les dépôts standards pour tous les formats de dépôt .
Étape suivante
- Pour savoir comment créer et gérer des règles de nettoyage, consultez Configurer des règles de nettoyage.