你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 Azure 容器注册表中的软删除策略恢复已删除的项目(预览版)

使用 Azure 容器注册表(ACR)可以启用 软删除策略 ,以便在设置的保留期内意外恢复已删除的项目。

重要说明

软删除策略目前以预览版提供。 有关 beta 版本、预览版或尚未正式发布的版本的 Azure 功能所适用的法律条款,请参阅 Microsoft Azure 预览版的补充使用条款

可以随时在 Azure 门户中或使用 Azure CLI 启用或禁用软删除策略。 在 ACR 中启用软删除策略时,注册表会将任何已删除的项目视为具有设置保留期的软删除项目。 在保留期内,可以列出、筛选和还原所有已删除的项目。 保留期到期后,软删除的项目将被永久删除,无法还原。

软删除工件生命周期示意图。

软删除项目的默认保留期为 7 天,但可以选择 1 到 90 天之间的任意值。 可以设置、更新和更改保留策略值。 保留期结束后,软删除的项目会过期。

自动清除程序每 24 小时运行一次,并在永久删除存储对象之前始终考虑保留天数的当前值。 例如,如果五天前删除了某个项目,则将保留值从 7 天更改为 14 天,则项目将在删除后的 14 天后过期。

此预览功能在所有 服务层级 (也称为 SKU)中可用。

注意

软删除的项目将按照存储的现行 SKU 定价计费。

请记住以下目前限制:

  • Azure 容器注册表当前不支持手动清除软删除的项目。
  • 软删除策略不支持为区域冗余或异地复制配置的注册表。
  • Azure 容器注册表不允许同时启用 保留策略 和软删除策略。

Prerequisites

  • 如果没有 Azure 帐户,请在开始前创建一个免费帐户

  • 若要执行软删除作,用户在容器注册表级别需要以下权限:

    • Microsoft.ContainerRegistry/registries/deleted/read:列出软删除的工件
    • Microsoft.ContainerRegistry/registries/deleted/restore/action:还原软删除的构件
  • 对于 Azure CLI,可以使用 Azure Cloud Shell 或本地安装来运行本文中列出的命令。 建议使用最新版本的 Azure CLI。 如需进行安装或升级,请参阅如何安装 Azure CLI

启用软删除策略

可以在 Azure 门户中或使用 Azure CLI 为 Azure 容器注册表启用软删除策略。

  1. 在 Azure 门户中转到 Azure 容器注册表。
  2. “概述”中,检查 软删除(预览版)的状态。
  3. 如果 状态“已禁用”,请选择“ 已禁用 ”以打开 “属性 ”窗格。
  4. 选中 “软删除 ”复选框。
  5. 输入介于 1 到 90 之间的天数以保留已删除的项目。
  6. 选择“保存”

显示用于在 Azure 门户中启用软删除的选项的屏幕截图。

启用软删除后,当您执行诸如取消清单的标记或删除工件之类的操作时,可以如下一部分所述,通过在保留期到期前选择 托管已删除的工件 来查看这些标记和工件。

查看和还原软删除的构件

可以在为存储库设置的当前保留期内查看和还原软删除的项目。 请谨记以下注意事项:

  • 不能同时在源资源和目标资源中导入已软删除的映像。
  • 将映像推送到软删除的存储库会还原该存储库。
  • 不允许推送与已软删除的图像共享相同清单摘要的图像。 而是恢复被软删除的映像。

还原软删除的构件

  1. 在 Azure 门户中转到 Azure 容器注册表。

  2. 在服务菜单中的 “服务”下,选择“ 存储库”。

  3. 存储库中,选择存储库。

  4. 选择“ 管理已删除的项目”。

    显示如何在 Azure 门户中访问“管理已删除的项目”选项的屏幕截图。

  5. 在要还原的已删除项目的行中,选择“ 还原”。

  6. “还原项目 ”窗格中,选择要还原的标记。 只能选择一个标记来还原工件。 若要恢复其他标记,必须单独还原它们。

  7. 选择 还原

还原软删除的存储库

  1. 在 Azure 门户中转到 Azure 容器注册表。
  2. 在服务菜单中的 “服务”下,选择“ 存储库”。
  3. 存储库中,选择存储库。
  4. 选择“ 管理已删除的存储库”。
  5. 在要还原的已删除存储库的行中,选择“ 还原”。
  6. “还原项目 ”窗格中,选择要还原的标记。 只能选择一个标签来还原你的存储库。 若要恢复其他标记,必须单独还原它们。
  7. 选择“还原”

Next steps