为 Container Registry 关停做好准备

确定您要如何为 Container Registry 关停做好准备。

Container Registry 已弃用。自 2025 年 3 月 18 日起，Container Registry 已关停，且无法将映像写入 Container Registry。

托管在 Artifact Registry 上的 gcr.io 网址（包括具有 gcr.io 网址的 Google 自有映像）不受 Container Registry 关闭的影响。

如需详细了解 Container Registry 弃用情况以及如何迁移到 Artifact Registry，请参阅 Container Registry 弃用。

Artifact Registry 是推荐用于在 Google Cloud上存储和管理容器映像的服务。Artifact Registry 提供的容器管理功能与 Container Registry 提供的相同，并且还包含其他功能和优势。

我需要做什么？

如果您在 Container Registry 中有想要继续使用的容器映像，或者您使用的服务（例如 App Engine）依赖于 Container Registry，则必须升级以使用 Artifact Registry 代码库。

2025 年 3 月 18 日之后会发生什么

Container Registry 关停分为三个阶段：

  • 自 2025 年 3 月 18 日起，无法将映像写入 Container Registry。
  • 自 2025 年 6 月 3 日起，Container Registry 中的映像将无法读取。

  • 自 2025 年 10 月 14 日起，如果您已完成在 Artifact Registry 中设置 gcr.io 仓库的步骤，那么推送到 gcr.io 端点的映像将存储在 Artifact Registry 中，并且所有 gcr.io 网址都将由 Artifact Registry 提供。Container Registry 中尚未复制到 Artifact Registry 的所有映像都将无法使用。

    2025 年 10 月 14 日之后，您仍可使用自动迁移工具进行迁移。

确定 Container Registry 使用情况并选择迁移选项

  1. 确定 Google Cloud 项目、文件夹或组织中的 Container Registry 使用情况。您可以使用我们的 Container Registry 使用情况工具来确定您是否在使用 Container Registry。

  2. 如果您在 Container Registry 中有想要继续使用的容器映像，请确定要采用哪种过渡选项。

  3. 如果您不需要 Container Registry 中存储的任何映像，则可以设置 Artifact Registry pkg.dev 代码库或 Artifact Registry gcr.io 代码库。

    如需了解 Container Registry 和 Artifact Registry 之间的区别，请查看以下内容：

使用我们的过渡工具

使用自动迁移工具从 Container Registry 迁移到托管在 Artifact Registry 上的 gcr.io 代码库或 pkg.dev Artifact Registry 代码库。

您可以将 Container Registry 端点迁移到 Artifact Registry gcr.io 代码库，而无需停机或中断服务。

自动迁移工具可以根据您选择的过渡路径执行以下操作：

  • 在 Artifact Registry 中，为列出的每个 gcr.io 项目在相应区域中创建 gcr.io 代码库或 pkg.dev 代码库。
  • 为每个代码库建议一个 IAM 政策，并根据用户偏好应用该政策或跳过应用。
  • 将所有流量从 gcr.io 端点重定向到 Artifact Registry。
  • 将存储在 Container Registry 中的所有容器映像复制到 Artifact Registry gcr.io 代码库或 pkg.dev 代码库，即使您已启用重定向也是如此。

如需查看有关如何使用自动迁移工具的说明，请参阅从 Container Registry 自动迁移到 Artifact Registry。

验证自动化和集成

验证现有自动化流程以及与 Cloud Build、Google Kubernetes Engine、Cloud Run 函数等服务的集成，或您用于从代码库推送或拉取代码的任何第三方工具是否按预期运行。

清理 Container Registry 映像

启用重定向后，用于删除 gcr.io 路径中映像的命令会删除相应 Artifact Registry gcr.io 制品库中的映像，但不会删除存储在 Container Registry 主机上的映像。

验证所有项目都适用于您选择的过渡选项，并且您要保留的所有映像都已复制到 Artifact Registry 后，您可以删除 Container Registry 存储分区。如需了解如何删除 Cloud Storage 存储分区，请参阅清理 Container Registry 中的映像。