Uma política de limpeza do Artifact Registry define critérios para excluir automaticamente versões de artefatos que não são mais necessárias ou para manter artefatos que você quer armazenar por tempo indeterminado.
As políticas de limpeza são úteis se você armazena muitas versões dos seus artefatos, mas só precisa manter versões específicas que são lançadas para produção. É possível definir políticas de exclusão com critérios para excluir artefatos e políticas de retenção com critérios para manter artefatos.
Se uma versão de artefato corresponder aos critérios de uma política de exclusão e de uma política de retenção, o Artifact Registry vai aplicar a política de retenção.
As exclusões acionadas por políticas de exclusão são contabilizadas na sua cota de solicitações de exclusão por projeto do Artifact Registry e são limitadas a 300.000 exclusões por repositório por dia.
Tipos de políticas de limpeza
Uma política de exclusão define a idade mínima ou máxima para a exclusão de artefatos, com critérios de filtragem adicionais disponíveis para limitar a política a artefatos específicos. Quando você tem uma política de exclusão ativa, também é possível configurar diferentes tipos de políticas de retenção para que o Artifact Registry mantenha artefatos específicos:
- Política de retenção condicional: define critérios para reter artefatos. É possível configurar políticas de retenção condicionais para manter artefatos que suas políticas de exclusão removeriam. Quando um artefato corresponde aos critérios de uma política de exclusão e de retenção, ele é mantido.
- Manter as versões mais recentes: define critérios para manter um intervalo específico de versões de artefato. Não é possível usar os critérios Manutenção condicional e Manter as versões mais recentes na mesma política de limpeza.
Ordem de aplicação da política
Se o repositório tiver mais de uma política de limpeza, o Artifact Registry vai aplicar as políticas em ordem, a menos que uma política de retenção corresponda à mesma imagem que uma política de exclusão. Por exemplo, seu repositório tem políticas de limpeza com as seguintes condições:
- Exclua imagens com mais de 100 dias.
- Mantenha as imagens com um prefixo de versão 2.0.6.
- Exclua imagens com uma tag
default.
Seu repositório contém imagens com os seguintes atributos:
| Imagem | Idade | Tag | Versão |
|---|---|---|---|
| Imagem A | 120 dias | default |
2.0.1 |
| Imagem B | 150 dias | default |
2.0.6 |
| Imagem C | 20 dias | patch |
1.9.2 |
Neste exemplo, a imagem A é excluída e a imagem C é mantida. A imagem B também é mantida porque a política de retenção corresponde à versão da imagem, mesmo que ela também corresponda aos critérios de exclusão da primeira e da terceira políticas.
Cronograma de aplicação da política
O Artifact Registry faz simulações e execuções ativas de políticas de limpeza usando um job em segundo plano que é executado periodicamente. As mudanças entram em vigor em aproximadamente um dia.
Número máximo de políticas de limpeza por repositório
É possível aplicar no máximo 10 políticas de limpeza a um repositório.
Formatos compatíveis
É possível definir uma política de limpeza em repositórios padrão e remotos para todos os formatos de repositório.
A seguir
- Para informações sobre como criar e gerenciar políticas de limpeza, consulte Configurar políticas de limpeza.