你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
使用 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 容器注册表启用软删除策略。
- Azure 门户
- Azure CLI
- 在 Azure 门户中转到 Azure 容器注册表。
- 在 “概述”中,检查 软删除(预览版)的状态。
- 如果 状态 为 “已禁用”,请选择“ 已禁用 ”以打开 “属性 ”窗格。
- 选中 “软删除 ”复选框。
- 输入介于 1 到 90 之间的天数以保留已删除的项目。
- 选择“保存”。
启用软删除后,当您执行诸如取消清单的标记或删除工件之类的操作时,可以如下一部分所述,通过在保留期到期前选择 托管已删除的工件 来查看这些标记和工件。
查看和还原软删除的构件
可以在为存储库设置的当前保留期内查看和还原软删除的项目。 请谨记以下注意事项:
- 不能同时在源资源和目标资源中导入已软删除的映像。
- 将映像推送到软删除的存储库会还原该存储库。
- 不允许推送与已软删除的图像共享相同清单摘要的图像。 而是恢复被软删除的映像。
- Azure 门户
- Azure CLI
还原软删除的构件
在 Azure 门户中转到 Azure 容器注册表。
在服务菜单中的 “服务”下,选择“ 存储库”。
在 存储库中,选择存储库。
选择“ 管理已删除的项目”。
在要还原的已删除项目的行中,选择“ 还原”。
在 “还原项目 ”窗格中,选择要还原的标记。 只能选择一个标记来还原工件。 若要恢复其他标记,必须单独还原它们。
选择 还原。
还原软删除的存储库
- 在 Azure 门户中转到 Azure 容器注册表。
- 在服务菜单中的 “服务”下,选择“ 存储库”。
- 在 存储库中,选择存储库。
- 选择“ 管理已删除的存储库”。
- 在要还原的已删除存储库的行中,选择“ 还原”。
- 在 “还原项目 ”窗格中,选择要还原的标记。 只能选择一个标签来还原你的存储库。 若要恢复其他标记,必须单独还原它们。
- 选择“还原”
Next steps
- 详细了解 Azure 容器注册表中用于删除映像和存储库的选项。