Documentação do Oracle Cloud Infrastructure

Mantendo e Excluindo Imagens Usando Políticas de Retenção

Descubra como configurar e usar políticas de retenção de imagem com o Container Registry.

Você pode configurar políticas de retenção de imagem para excluir automaticamente imagens que atendam a critérios de seleção específicos, a saber:

  • Imagens que não foram retiradas por um determinado número de dias.

  • Imagens que não têm controle de versão por um determinado número de dias.

  • Imagens que não receberam identificadores de versão específicos especificados como isentos de exclusão automática.

Um processo por hora verifica as imagens com relação aos critérios de seleção, e todas que atendam aos critérios de seleção são excluídas automaticamente.

Você verá que as políticas de retenção de imagem são uma maneira mais conveniente de gerenciar as imagens em um repositório do que excluir manualmente imagens individuais (consulte Excluindo uma Imagem).

Em cada região em uma tenancy, há uma política global de retenção de imagem. Os critérios de seleção padrão da política global de retenção de imagem mantêm todas as imagens para que nenhuma imagem seja excluída automaticamente. No entanto, você pode alterar a política global de retenção de imagem para que as imagens sejam excluídas se atenderem aos critérios especificados. A política global de retenção de imagem de uma região se aplica a todos os repositórios da região, a menos que ela seja explicitamente substituída por uma ou mais políticas personalizadas de retenção de imagem.

Você pode configurar políticas personalizadas de retenção de imagem para substituir a política global de retenção de imagem por outros critérios de repositórios específicos em uma região. Depois de criar uma política personalizada de retenção de imagem, você aplica a política personalizada de retenção a um repositório adicionando o repositório à política. A política global de retenção de imagem não será mais aplicada aos repositórios adicionados a uma política personalizada de retenção.

Se você tiver a permissão manage na tenancy, poderá executar as seguintes tarefas:

  • Modifique a política global de retenção de imagem de cada região.

  • Crie novas políticas personalizadas de retenção de imagem.

  • Modificar os critérios das políticas personalizadas de retenção de imagem existentes.

  • Excluir políticas personalizadas de retenção de imagem.

Se você tiver a permissão manage em um repositório, poderá:

  • Adicionar o repositório a uma política personalizada de retenção de imagem.

  • Remova o repositório de uma política personalizada de retenção de imagem.

Observe o seguinte:

  • Somente uma política personalizada de retenção de imagem por vez pode ser aplicada a um repositório. Se um repositório já tiver sido adicionado a uma política personalizada de retenção e você quiser adicionar o repositório a outra política personalizada de retenção, será necessário remover o repositório da primeira política de retenção antes de adicioná-lo à segunda.

  • Quando você criar ou atualizar uma política de retenção de imagem, o processo por hora que verifica a exclusão de imagens ignorará a política nova ou atualizada por várias horas. Esse período de espera permite refinar os critérios de política para selecionar apenas as imagens que você deseja excluir e, portanto, reduz a chance de imagens serem excluídas inesperadamente. Após esse período, a política é incluída no processo por hora, e as imagens são verificadas e excluídas de acordo.

  • A política global de retenção de imagem e qualquer política personalizada de retenção de imagem que você criar são específicas para uma determinada região. Para excluir imagens consistentemente em diferentes regiões em sua tenancy, configure políticas de retenção de imagem em cada região com critérios de seleção idênticos.

  • Quando você exclui uma imagem, pode levar até 48 horas para que a exclusão tenha efeito e para que o armazenamento seja liberado. Se você estiver excluindo imagens para liberar armazenamento, também poderá entre em contato conosco para obter mais armazenamento.

Usando a Console para Editar a Política Global de Retenção de Imagem

Desde que você tenha a permissão manage na tenancy, poderá editar a política global de retenção de imagem da região que se aplica a todos os repositórios em uma região (exceto para repositórios que foram adicionados explicitamente a uma política personalizada de retenção de imagem).

  1. Na página da lista Registro de Contêiner, selecione Definições. Se precisar de ajuda para encontrar a página de lista ou o repositório, consulte Listando Repositórios.

    Você vê os critérios de seleção atuais da política global de retenção de imagem da região, junto com quaisquer políticas personalizadas de retenção de imagem que substituem a política global de retenção de imagem de repositórios específicos.

  2. Selecione Editar política global.
  3. No painel Política global de retenção de imagem, especifique novos critérios para a política global de retenção:
    • Excluir todas as imagens que não foram extraídas no número especificado de dias: Selecione esta opção para excluir imagens que não foram extraídas pelo número de dias que você especificar. Para evitar a exclusão de imagens com controle de versão que não foram extraídas no número de dias selecionado, use o campo Versões de Isenção para especificar identificadores de versão específicos como isentos da exclusão.
    • Excluir quaisquer imagens que não tenham sido controladas por versão no número especificado de dias: Selecione esta opção para excluir imagens que não tenham sido controladas por versão pelo número de dias especificado. Observe que o campo Versões de isenção não se aplica quando você seleciona essa opção.
    • Versões isentas: Para impedir a exclusão de imagens com controle de versão que não foram extraídas no número de dias selecionado, especifique identificadores de versão específicos como isentos da exclusão. As imagens que receberam um dos identificadores de versão isentos especificados não são excluídas. Use uma lista separada por vírgulas para especificar vários identificadores de versão. Você pode incluir o asterisco (*) como curinga para representar nenhum, um ou mais caracteres. Por exemplo, você pode especificar latest,prod-*,*-tail,*.100.*.
  4. Selecione Salvar alterações.

A partir de então, os critérios que você informou para a política global de retenção de imagem da região serão aplicados a todos os repositórios da região, exceto aos repositórios que foram explicitamente adicionados a uma política personalizada de retenção de imagem. As imagens nos repositórios que não forem adicionadas a uma política personalizada de retenção de imagem serão excluídas do Container Registry se atenderem aos critérios especificados na política global de retenção de imagem.

Quando você criar ou atualizar uma política de retenção de imagem, o processo por hora que verifica a exclusão de imagens ignorará a política nova ou atualizada por várias horas. Esse período de espera permite refinar os critérios de política para selecionar apenas as imagens que você deseja excluir e, portanto, reduz a chance de imagens serem excluídas inesperadamente. Após esse período, a política é incluída no processo por hora, e as imagens são verificadas e excluídas de acordo.

Usando a Console para Criar uma Nova Política Personalizada de Retenção de Imagem para Substituir a Política Global

Desde que você tenha a permissão manage na tenancy, poderá criar uma nova política personalizada de retenção de imagem para substituir a política global de retenção de imagem da região dos repositórios especificados. Uma política personalizada de retenção de imagem é específica para a região em que você a cria.

  1. Na página da lista Registro de Contêiner, selecione Definições. Se precisar de ajuda para encontrar a página de lista ou o repositório, consulte Listando Repositórios.

    Você vê os critérios de seleção atuais da política global de retenção de imagem da região, junto com quaisquer políticas personalizadas de retenção de imagem que substituem a política global de retenção de imagem de repositórios específicos.

  2. Selecione Outra política de substituição.
  3. Na caixa de diálogo Criar política de substituição de retenção de imagem, especifique critérios para a nova política de retenção:

    • Nome da política: Um nome de sua escolha para a política. Evite digitar informações confidenciais.

    • Excluir todas as imagens que não foram extraídas no número especificado de dias: Selecione esta opção para excluir imagens que não foram extraídas pelo número de dias que você especificar. Para evitar a exclusão de imagens com controle de versão que não foram extraídas no número de dias selecionado, use o campo Versões de Isenção para especificar identificadores de versão específicos como isentos da exclusão.

    • Excluir quaisquer imagens que não tenham sido controladas por versão no número especificado de dias: Selecione esta opção para excluir imagens que não tenham sido controladas por versão pelo número de dias especificado. Observe que o campo Versões de isenção não se aplica quando você seleciona essa opção.

    • Versões isentas: Para impedir a exclusão de imagens com controle de versão que não foram extraídas no número de dias selecionado, especifique identificadores de versão específicos como isentos da exclusão. As imagens que receberam um dos identificadores de versão isentos especificados não são excluídas. Use uma lista separada por vírgulas para especificar vários identificadores de versão. Você pode incluir o asterisco (*) como curinga para representar nenhum, um ou mais caracteres. Por exemplo, você pode especificar latest,prod-*,*-tail,*.100.*.

  4. Selecione Salvar alterações.

Agora você pode adicionar repositórios à nova política de retenção personalizada.

Usando a Console para Remover um Repositório de uma Política Personalizada de Retenção de Imagem

Desde que você tenha a permissão manage em um repositório, poderá remover um repositório de uma política personalizada de retenção de imagem à qual ele foi adicionado anteriormente.

Talvez você queira remover o repositório de uma política personalizada de retenção de imagem:

  • Se você quiser que a política global de retenção de imagem da região seja aplicada ao repositório.

  • Se você quiser que outra política personalizada de retenção de imagem seja aplicada ao repositório (apenas uma política personalizada de retenção de imagem pode ser aplicada por vez a um repositório).

  1. Na página da lista Registro de Contêiner, selecione Definições. Se precisar de ajuda para encontrar a página de lista ou o repositório, consulte Listando Repositórios.

    Você vê os critérios de seleção atuais da política global de retenção de imagem da região, junto com quaisquer políticas personalizadas de retenção de imagem que substituem a política global de retenção de imagem de repositórios específicos.

  2. Selecione Editar política de substituição ao lado da política personalizada de retenção de imagem à qual o repositório foi adicionado.
  3. Selecione o ícone de exclusão ao lado do nome do repositório para removê-lo da política personalizada de retenção de imagem.
  4. Selecione Salvar alterações.

A partir de então, a política global de retenção de imagem da região será aplicada ao repositório (a menos que você adicione o repositório a outra política personalizada de retenção de imagem). As imagens do repositório serão excluídas do Container Registry se atenderem aos critérios especificados na política global de retenção de imagem.

Quando você criar ou atualizar uma política de retenção de imagem, o processo por hora que verifica a exclusão de imagens ignorará a política nova ou atualizada por várias horas. Esse período de espera permite refinar os critérios de política para selecionar apenas as imagens que você deseja excluir e, portanto, reduz a chance de imagens serem excluídas inesperadamente. Após esse período, a política é incluída no processo por hora, e as imagens são verificadas e excluídas de acordo.

Usando a Console para Adicionar um Repositório a uma Política Personalizada de Retenção de Imagem

Desde que você tenha a permissão manage em um repositório, poderá adicionar um repositório a uma política personalizada de retenção de imagem existente.

Observe que, se uma política personalizada de retenção de imagem já se aplicar ao repositório, você deverá remover o repositório da política atual antes de adicioná-lo a outra política. Observe também que uma política personalizada de retenção de imagem é específica para a região na qual ela foi criada.

  1. Na página da lista Registro de Contêiner, selecione Definições. Se precisar de ajuda para encontrar a página de lista ou o repositório, consulte Listando Repositórios.

    Você vê os critérios de seleção atuais da política global de retenção de imagem da região, junto com quaisquer políticas personalizadas de retenção de imagem que substituem a política global de retenção de imagem de repositórios específicos.

  2. Selecione Editar política de substituição ao lado da política personalizada de retenção de imagem à qual você deseja adicionar o repositório.
  3. Selecione Outro repositório e selecione na lista o repositório que você deseja adicionar à política personalizada de retenção de imagem.

    Observe que a lista de repositórios inclui todos os repositórios da região, independentemente de você ter permissão para adicioná-los a uma política de retenção. Você só poderá adicionar um repositório a uma política de retenção se tiver a permissão manage nesse repositório.

    Se um repositório da lista tiver um nome de política ao lado dele, o repositório já foi adicionado a uma política. Para poder adicionar o repositório a outra política, você deverá removê-lo da primeira política.

  4. Selecione Salvar alterações.

A partir de então, a política personalizada de retenção à qual você adicionou o repositório substituirá a política global de retenção de imagem da região. As imagens do repositório serão excluídas do Container Registry se atenderem aos critérios especificados na política personalizada de retenção.

Quando você criar ou atualizar uma política de retenção de imagem, o processo por hora que verifica a exclusão de imagens ignorará a política nova ou atualizada por várias horas. Esse período de espera permite refinar os critérios de política para selecionar apenas as imagens que você deseja excluir e, portanto, reduz a chance de imagens serem excluídas inesperadamente. Após esse período, a política é incluída no processo por hora, e as imagens são verificadas e excluídas de acordo.