了解在使用 Artifact Registry 时适用于所有工件格式的问题排查步骤。如需了解特定工件格式的问题,请参阅特定格式的页面。
命令中的代码库或位置无效
请使用以下信息来帮助您诊断无效代码库位置或无效代码库名称错误。
gcloud 的默认位置和代码库
如果您在 Google Cloud CLI 中设置了默认代码库和位置,以便从 gcloud artifacts
命令中省略 --location
和 --repository
标志,请尝试使用这些标志和相应值运行之前失败的命令。如需详细了解特定命令的语法,请使用 --help
标志运行该命令。
默认代码库设置不适用于您在指定代码库名称时未使用 --repository
标志的 gcloud artifacts
命令。例如,您必须在 gcloud artifacts repositories describe 命令中指定代码库名称,如以下示例所示:
gcloud artifacts repositories describe my-repo --location=us-west1
如果命令仍失败,您可能需要验证是否为代码库或位置指定了有效的值。
代码库位置
如需列出所有受支持的 Artifact Registry 位置,请运行以下命令:
gcloud artifacts locations list
您的组织政策可能包含位置限制。Artifact Registry 会在创建代码库时强制执行这些限制。Artifact Registry 不会对发布时间早于位置限制生效日期的代码库追溯性强制执行政策。
gcloud 命令中的代码库名称
您可以列出代码库,以查看指定项目或位置中的代码库名称。
如需列出项目中的所有代码库,请运行以下命令:
gcloud artifacts repositories list --project=PROJECT-ID \
--location=all
如需列出某个位置中的所有代码库,请运行以下命令:
gcloud artifacts repositories list --project=PROJECT-ID \
--location=LOCATION
将 PROJECT-ID 替换为您的 Google Cloud 项目 ID,将 LOCATION 替换为仓库位置。
该命令会返回每个代码库的信息,类似于以下示例:
REPOSITORY: my-repo
FORMAT: DOCKER
DESCRIPTION:
LOCATION: us-west1
LABELS:
ENCRYPTION: Google-managed key
CREATE_TIME: 2021-09-23T19:39:10
UPDATE_TIME: 2021-09-23T19:39:10
REPOSITORY
的值是您在将代码库名称作为参数包含在 gcloud artifacts
命令中时使用的值。
例如,以下命令使用 --repository
标志:
gcloud artifacts packages list --location=us-west1 --repository=my-repo
此命令仅使用代码库名称,不带标志:
gcloud artifacts repositories describe my-repo --location=us-west1
使用第三方客户端的代码库名称
对于第三方客户端,您通常在配置客户端时使用完整的代码库路径,例如 us-west1-docker.pkg.dev/my-project/my-repo
。然后,您可以按照客户端的惯例上传和下载软件包。如需详细了解客户端配置和使用,请参阅您所用格式的文档。
- 路径无效:
us-east1-docker.pkg.dev/my-project/my-image
- 有效路径:
us-east1-docker.pkg.dev/my-project/my-repo/my-image
无法向未删除的代码库推送或从中拉取内容
取消删除 Google Cloud项目或在停用后启用 Artifact Registry API 后,代码库无法正常运行。
如果您停用 Artifact Registry API 或删除项目,Artifact Registry 服务将不可用。Artifact Registry 会在 7 天后删除代码库数据。