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 indefinidamente.
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 você lança na produção. É possível definir políticas de exclusão com critérios para excluir artefatos e políticas de manutenção com critérios para reter artefatos.
As exclusões acionadas por políticas de exclusão são contabilizadas na cota de solicitações de exclusão por projeto do Artifact Registry e são limitadas a 600.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 outros critérios de filtragem 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 manutenção para que o Artifact Registry mantenha artefatos específicos:
- Política de manutenção condicional: define critérios para reter artefatos. É possível configurar políticas de manutenção condicionais para manter artefatos que suas políticas de exclusão removeriam. Quando um artefato atende aos critérios de uma política de exclusão e de uma política de manutenção, ele é mantido.
- Manter as versões mais recentes: define critérios para manter um intervalo específico de versões de artefatos. Não é possível usar os critérios Manutenção condicional e Manter as versões mais recentes na mesma política de limpeza.
Prioridade de políticas que correspondem à mesma imagem
Se uma versão de artefato atender aos critérios de uma política de exclusão e de uma política de manutenção, o Artifact Registry vai aplicar a política de manutenção.
Se uma versão de artefato atender a várias políticas de exclusão, o Artifact Registry vai aplicar a política de exclusão com o período de armazenamento mais curto. Por exemplo, você tem duas políticas de exclusão:
- Política de exclusão 1: exclui todas as imagens com tags que começam com
commit-após 24 horas. - Política de exclusão 2: exclui todas as imagens marcadas após sete dias.
Uma imagem marcada como commit-1234 atende às duas políticas. Como a Política 1 tem um período de armazenamento mais curto, a imagem é excluída após 24 horas.
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 manutenção corresponda à mesma imagem que uma política de exclusão. Por exemplo, seu repositório tem políticas de revisão dos dados com as seguintes condições:
- Excluir imagens com mais de 100 dias.
- Manter imagens com um prefixo de versão de 2.0.6.
- Excluir 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 devido à política de manutenção que corresponde à versão da imagem, mesmo que a imagem B também atenda aos critérios de exclusão das primeira e terceira políticas.
Programação de aplicação da política
O Artifact Registry realiza 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 um máximo de 10 políticas de revisão dos dados a um repositório.
Formatos compatíveis
É possível definir uma política de revisão dos dados em repositórios padrão para todos os formatos de repositório.
A seguir
- Para informações sobre como criar e gerenciar políticas de revisão dos dados, consulte Configurar políticas de revisão dos dados.