Partager via

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

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

重要

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

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

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

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

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

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

注意

软删除的工件根据存储的活动 SKU 定价计费。

请记住以下目前限制：

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

先决条件

  • 如果没有 Azure 帐户，请在开始之前创建 一个试用订阅 。

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

    • Microsoft.ContainerRegistry/registries/deleted/read：列出软删除的项目
    • Microsoft.ContainerRegistry/registries/deleted/restore/action：还原软删除的构件

  • 对于 Azure CLI，可以使用本地安装来运行本文中列出的命令。 建议使用最新版本的 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. 选择“还原”

后续步骤

  • Last updated on