区域 ID
REGION_ID
是 Google 根据您在创建应用时选择的区域分配的缩写代码。此代码不对应于国家/地区或省,尽管某些区域 ID 可能类似于常用国家/地区代码和省代码。对于 2020 年 2 月以后创建的应用,REGION_ID.r
包含在 App Engine 网址中。对于在此日期之前创建的现有应用,网址中的区域 ID 是可选的。
详细了解区域 ID。
Container Registry 已弃用,并已于 2025 年 3 月 18 日关停。 我们建议您使用 Artifact Registry 来存储和管理容器映像。默认情况下,2025 年 3 月 5 日之后创建的新部署使用 Artifact Registry(而非 Container Registry)来存储应用映像。Artifact Registry 提供的容器管理功能与 Container Registry 提供的相同,并包含其他功能和优势。作为同时支持容器映像和非容器工件的全托管式服务,Artifact Registry 对 Container Registry 的功能进行了扩展。
对于在 2024 年 5 月之前创建或尚未运行自动迁移工具的项目,请按照本指南中的步骤操作,让 App Engine 自动迁移您的部署流程。
App Engine 标准环境
标准环境中的大多数应用组件都遵循自动迁移过程。不过,为了顺利过渡到 Artifact Registry,请确保您的服务账号具有以下所需权限:
对于现有的标准部署,部署服务账号(App Engine 默认服务账号 (
PROJECT_ID@appspot.gserviceaccount.com
) 或您的自定义服务账号)必须具有授予明确的 Artifact Registry 写入权限artifactregistry.repositories.uploadArtifacts
的角色。如需查找与您的部署服务账号关联的角色,请参阅管理对服务账号的访问权限。如果与部署关联的服务账号具有以下任何角色,则新部署可以使用 Artifact Registry:
具有写入权限的预定义 Artifact Registry 角色,例如 Artifact Registry Writer (
roles/artifactregistry.writer
)。授予
artifactregistry.repositories.uploadArtifacts
权限的自定义角色。您可以通过 Google Cloud 控制台或运行gcloud iam roles describe
命令验证自定义角色访问权限。
如果不具备这些角色,请向您的部署服务账号授予 Artifact Registry Writer 角色 (
roles/artifactregistry.writer
)。
如果未提供所需权限,您将无法在标准环境中部署新版本。
在自动迁移期间, Google Cloud 可能会创建新的代码库,并将映像从 Container Registry 复制到 Artifact Registry。
App Engine 柔性环境
柔性环境中的大多数应用组件都遵循自动迁移过程。不过,为了顺利过渡到 Artifact Registry,请确保您的服务账号具有以下所需权限:
为了让现有的灵活部署能够按预期在 Artifact Registry 中运行,部署服务账号(App Engine 默认服务账号 (
PROJECT_ID@appspot.gserviceaccount.com
) 或您的自定义服务账号)必须具有可授予明确的 Artifact Registry 权限的角色,例如用于读取的artifactregistry.repositories.downloadArtifacts
和用于写入的artifactregistry.repositories.uploadArtifacts
。如需查找与您的部署服务账号关联的角色,请参阅管理对服务账号的访问权限。如果与部署关联的服务账号具有以下任何角色,则新部署可以使用 Artifact Registry:
具有读取和写入权限的预定义 Artifact Registry 角色,例如 Artifact Registry Writer (
roles/artifactregistry.writer
)。可授予
artifactregistry.repositories.downloadArtifacts
和artifactregistry.repositories.uploadArtifacts
权限的自定义角色。您可以通过 Google Cloud 控制台或运行gcloud iam roles describe
命令验证自定义角色访问权限。
如果不具备这些角色,请向您的部署服务账号授予 Artifact Registry Repository Administrator 角色 (
roles/artifactregistry.repoAdmin
)。
如果未提供所需权限,您将无法在柔性环境中部署应用。扩缩和重启实例也会失败。
在自动迁移期间, Google Cloud 可能会创建新的代码库,并将映像从 Container Registry 复制到 Artifact Registry。
迁移到 Artifact Registry 以用于手动构建的容器映像
如果您之前是使用 Container Registry 中的预构建或手动构建的容器映像来部署应用,则自动迁移过程不适用。例如,如果您使用 Docker 构建容器映像,将这些映像推送到 Container Registry,并使用 gcloud app deploy --image-url
命令部署应用,那么自动迁移过程将无法正常运行。
如果您使用 Container Registry 中的预构建或手动构建的容器映像来部署应用,请选择以下选项之一来迁移到 Artifact Registry:
使用自动迁移工具从 Container Registry 迁移到托管在 Artifact Registry 上的
gcr.io
代码库。如果您使用此工具,则无需重新部署服务的新版本。如需了解详情,请参阅自动从 Container Registry 迁移到 Artifact Registry。手动将容器映像从 Container Registry 移至 Artifact Registry,并重新部署服务的新版本。如需了解详情,请参阅手动迁移到 Artifact Registry 中的
gcr.io
代码库。使用
copy-only
标志将容器映像复制到 Artifact Registry,并重新部署服务的新版本。