為 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 中的容器映像檔，或是使用依附於 Container Registry 的服務 (例如 App Engine)，就必須升級以使用 Artifact Registry 存放區。

2025 年 3 月 18 日後會有什麼變化

Container Registry 終止服務分為三個階段：

  • 自 2025 年 3 月 18 日起，您將無法將映像檔寫入 Container Registry。
  • 自 2025 年 6 月 3 日起，您將無法讀取 Container Registry 中的映像檔。

  • 自 2025 年 7 月 17 日起，如果您已完成在 Artifact Registry 中設定gcr.io存放區的步驟，則推送至 gcr.io 端點會將映像檔儲存在 Artifact Registry 中，且所有 gcr.io 網址都會從 Artifact Registry 提供。如果 Container Registry 中的映像檔未複製到 Artifact Registry，就無法使用。

    2025 年 7 月 17 日後，您仍可使用自動遷移工具進行遷移。

找出 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 儲存空間 bucket。如需如何刪除 Cloud Storage 值區的操作說明，請參閱清除 Container Registry 中的映像檔。