常规问题排查

了解适用于下列情况的所有工件格式的问题排查步骤 与 Artifact Registry 搭配使用对于特定于工件格式的问题 请参阅针对具体格式的页面。

命令中的代码库或位置无效

使用以下信息来诊断无效的代码库位置 或“代码库名称无效”错误

gcloud 的位置和代码库默认值

如果您在 Google Cloud CLI 中设置了默认代码库和位置,以便从 gcloud artifacts 命令中省略 --location--repository 标志,请尝试使用这些标志和相应值运行之前失败的命令。如需详细了解特定命令的语法,请使用 --help 标志运行该命令。

默认代码库设置不适用于您在未使用 --repository 标志的情况下指定代码库名称的 gcloud artifacts 命令。对于 您必须在 gcloudartifacts 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: MAVEN
DESCRIPTION:
LOCATION: us-east1
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-east1 --repository=my-repo

此命令仅使用代码库名称,而不使用标志:

gcloud artifacts repositories describe my-repo --location=us-west1

使用第三方客户端的代码库名称

对于第三方客户端,您通常在配置客户端时使用完整的代码库路径,例如 us-east1-docker.pkg.dev/my-project/my-repo。然后,您可以按照客户端的惯例上传和下载软件包。如需详细了解客户端配置和用法,请参阅相关文档 选择的格式

如果您要从 Container Registry 过渡,请注意,所有映像路径都必须包含 Artifact Registry 代码库名称。您不能指定仅包含项目 ID 的图片路径。

  • 路径无效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 天后删除代码库数据。

详细了解 Google Cloud 上的数据删除机制