Recuperar artefatos excluídos com a política de exclusão flexível no Registro de Contêiner do Azure (Visualização)

O Azure Container Registry (ACR) permite que você habilite a política de exclusão flexível para recuperar quaisquer artefatos excluídos acidentalmente por um período de retenção definido.

Aspetos da política de exclusão suave

A política de exclusão suave pode ser ativada/desativada a qualquer momento. Depois de habilitar a política de exclusão suave no ACR, ela gerencia os artefatos excluídos como artefatos excluídos suavemente com um período de retenção definido. Assim, você tem a capacidade de listar, filtrar e restaurar os artefatos excluídos suavemente.

Período de retenção

O período de retenção padrão para artefatos excluídos suavemente é de sete dias, mas é possível definir o valor do período de retenção entre um a 90 dias. Você pode definir, atualizar e alterar o valor da política de retenção. Os artefatos excluídos suavemente expiram quando o período de retenção é concluído.

Purga automática

A limpeza automática é executada a cada 24 horas e sempre considera o valor atual dos dias de retenção antes de excluir permanentemente os artefatos excluídos suavemente. Por exemplo, após cinco dias de exclusão suave do artefato, se você alterar o valor dos dias de retenção de sete para 14 dias, o artefato só expirará após 14 dias da exclusão suave inicial.

Informações sobre disponibilidade e preços

Esse recurso está disponível em todas as camadas de serviço (também conhecidas como SKUs). Para obter informações sobre camadas de serviço do Registro, consulte Camadas de serviço do Registro de Contêiner do Azure.

Nota

Os artefatos excluídos por software são cobrados de acordo com o preço de sku ativo para armazenamento.

Limitações de pré-visualização

Importante

A política de exclusão suave está atualmente em visualização. Veja Termos de Utilização Complementares da Pré-visualizações do Microsoft Azure para obter os termos legais que se aplicam às funcionalidades do Azure que estão na versão beta, na pré-visualização ou que ainda não foram lançadas para disponibilidade geral.

• Atualmente, o ACR não suporta a limpeza manual de artefatos excluídos por software.
• A política de exclusão suave não oferece suporte a um registro replicado geograficamente.
• O ACR não permite ativar a política de retenção e a política de exclusão suave. Consulte a política de retenção para manifestos não marcados.

Pré-requisitos

• O usuário requer as seguintes permissões (no nível do Registro) para executar operações de exclusão suave:

Permissão	Description
Microsoft.ContainerRegistry/registries/deleted/read	Listar artefatos excluídos suavemente
Microsoft.ContainerRegistry/registries/deleted/restore/action	Restaurar artefato excluído suavemente

• Você pode usar o Azure Cloud Shell ou uma instalação local da CLI do Azure para executar os exemplos de comando neste artigo. Se você quiser usá-lo localmente, a versão 2.0.74 ou posterior é necessária. Execute az --version para a versão. Se precisar de instalar ou atualizar, veja Install Azure CLI (Instalar o Azure CLI).

• Inicie sessão no portal do Azure.

Habilitar a política de exclusão suave para o registro - CLI

1. Atualize a política de exclusão suave para um determinado MyRegistry ACR com um período de retenção definido entre 1 e 90 dias.

   az acr config soft-delete update -r MyRegistry --days 7 --status <enabled/disabled>
   

2. Mostrar a política de exclusão suave configurada para um determinado MyRegistry ACR.

   az acr config soft-delete show -r MyRegistry 
   

Listar os artefatos excluídos suavemente - CLI

Os az acr repository list-deleted comandos permitem a busca e listagem dos repositórios excluídos suavemente. Para mais informações, utilize --help.

1. Liste os repositórios excluídos suavemente em um determinado MyRegistry ACR.

   az acr repository list-deleted -n MyRegistry
   

Os az acr manifest list-deleted comandos permitem buscar e listar os manifestos de exclusão suave.

2. Liste os manifestos excluídos suavemente de um repositório em um hello-world determinado MyRegistry ACR.

   az acr manifest list-deleted -r MyRegistry -n hello-world
   

Os az acr manifest list-deleted-tags comandos permitem buscar e listar as tags de exclusão suave.

3. Liste as tags soft delete de um repositório em um hello-world determinado MyRegistry ACR.

   az acr manifest list-deleted-tags -r MyRegistry -n hello-world
   

4. Filtre as tags soft delete de um repositório para corresponder à tag latest em um hello-world determinado MyRegistry ACR.

   az acr manifest list-deleted-tags -r MyRegistry -n hello-world:latest
   

Restaurar os artefatos excluídos suavemente - CLI

Os az acr manifest restore comandos restauram uma única imagem por tag e digest.

1. Restaure a imagem de um repositório por tag lateste digest sha256:abc123 em um hello-world determinado MyRegistry ACR.

   az acr manifest restore -r MyRegistry -n hello-world:latest -d sha256:abc123
   

2. Restaure o manifesto excluído mais recentemente de um repositório por tag latest em um hello-world determinado MyRegistry ACR.

   az acr manifest restore -r MyRegistry -n hello-world:latest
   

Force restore substitui a tag existente com o mesmo nome no repositório. Se a política de exclusão suave estiver habilitada durante a restauração forçada. A tag substituída é excluída suavemente. Você pode forçar a restauração com argumentos --force, -fespecíficos.

3. Força restaurar a imagem de um repositório por tag lateste digest sha256:abc123 em um hello-world determinado MyRegistry ACR.

   az acr manifest restore -r MyRegistry -n hello-world:latest -d sha256:abc123 -f
   

Importante

A restauração de uma lista de manifestos não restaurará recursivamente nenhum manifesto excluído suave subjacente. Se você estiver restaurando artefatos ORAS excluídos suavemente, a restauração de um assunto não restaurará recursivamente a cadeia de referência. Além disso, o assunto tem que ser restaurado primeiro, só então um manifesto de referência é permitido restaurar. Caso contrário, lança um erro.

Ativar política de exclusão suave para registro - Portal

Você também pode habilitar a política de exclusão suave de um registro no portal do Azure.

1. Navegue até o Registro de Contêiner do Azure.
2. Na guia Visão geral, verifique o status da exclusão suave (visualização).
3. Se o status estiver desativado, selecione Atualizar.

4. Marque a caixa de seleção para Ativar exclusão suave.
5. Selecione o número de dias entre 0 e 90 dias para reter os artefatos excluídos suavemente.
6. Selecione Guardar para guardar as alterações.

Restaurar os artefatos excluídos suavemente - Portal

1. Navegue até o Registro de Contêiner do Azure.
2. Na seção Menu, selecione Serviços e selecione Repositórios.
3. Nos repositórios, selecione seu repositório preferido.
4. Selecione Gerenciar artefatos excluídos para ver todos os artefatos excluídos suavemente.

Nota

Depois de habilitar a política de exclusão suave e executar ações como desmarcar um manifesto ou excluir um artefato, você poderá encontrar essas tags e artefatos nos artefatos de exclusão gerenciada antes que o número de dias de retenção expire.

5. Filtre o artefato excluído que você precisa restaurar.
6. Selecione o artefato e selecione Restaurar na coluna da direita.
7. Uma janela Restaurar artefato aparece.

8. Selecione a tag para restaurar, aqui você tem uma opção para escolher, e recuperar quaisquer tags adicionais.
9. Selecione Restaurar.

Restaurar a partir de repositórios excluídos suavemente - Portal

1. Navegue até o Registro de Contêiner do Azure.
2. Na seção Menu, selecione Serviços,
3. Na guia Serviços, selecione Repositórios.
4. Na guia Repositórios, selecione Gerenciar repositórios excluídos.

5. Filtre o repositório excluído nos repositórios excluídos suavemente (Visualização).

6. Selecione o repositório excluído, filtre o artefato excluído em Gerenciar artefatos excluídos.
7. Selecione o artefato e selecione Restaurar na coluna da direita.
8. Uma janela Restaurar artefato aparece.

9. Selecione a tag para restaurar, aqui você tem uma opção para escolher, e recuperar quaisquer outras tags.
10. Selecione Restaurar.

Importante

A importação de uma imagem excluída suavemente nos recursos de origem e de destino está bloqueada. Enviar uma imagem para o repositório excluído suavemente restaurará o repositório excluído suavemente. Não é permitido enviar uma imagem que compartilha um mesmo resumo de manifesto com a imagem excluída suavemente. Em vez disso, restaure a imagem excluída suavemente.

Próximos passos

• Saiba mais sobre as opções para excluir imagens e repositórios no Registro de Contêiner do Azure.