了解以下可能会对您有所帮助的问题排查步骤 如何在 Artifact Registry 中管理操作系统软件包时遇到问题。
了解如何解决 Artifact Registry Remote 相关问题 操作系统软件包的代码库,请参阅 排查远程仓库问题。
身份验证和权限问题
您无法连接到代码库执行安装软件包等操作。软件包管理器的输出包含 401
或 403
错误,
表示身份验证或权限存在问题。
Apt 错误示例:
Err:1 ar+https://us-central1-apt.pkg.dev/projects/my-project my-package Release Error downloading: code 401
E: Failed to fetch https://us-central1-apt.pkg.dev/projects/my-project/dists/quickstart-apt-repo/main/binary-amd64/Packages 403 Forbidden [IP: 74.125.20.82 443] E: Some index files failed to download. They have been ignored, or old ones used instead.
Yum 错误示例:
/repodata/repomd.xml: [Errno 14] HTTPS Error 403 - Forbidden
导致这些错误的原因有很多。确保您的虚拟机符合以下要求:
验证虚拟机是否具有关联的服务账号。
Compute Engine 虚拟机
- 转到虚拟机实例页面。
在虚拟机列表中,点击虚拟机的名称。
在详细信息标签页的 API 和身份管理下方,会显示服务账号和访问权限范围。
默认情况下,Compute Engine 虚拟机使用 Compute Engine 默认服务账号,并且具有一组有限的访问范围。默认服务账号电子邮件地址的格式为
PROJECT_NUMBER-compute@developer.gserviceaccount.com
。如需更改服务账号或将服务账号附加到虚拟机,请参阅 更改实例的服务账号和访问权限范围。
其他虚拟机
对于其他虚拟机,您必须拥有一个服务账号来代表该虚拟机执行操作。
创建一个服务账号(如果您还没有服务账号)。
在创建服务账号时授予 Artifact Registry Reader (
roles.artifactregistry.reader
) 角色,这样您就不必在单独的步骤中配置权限。
确保虚拟机服务账号拥有对代码库的读取权限以及
cloud-platform
API 访问权限范围。Compute Engine 虚拟机
Artifact Registry 会自动检索虚拟机服务账号凭据。通过 取决于您是否使用默认 服务账号或用户代管式服务账号。
- 默认服务账号
如果虚拟机使用默认服务账号,则此服务 账号默认具有“编辑者”角色,其中包括读取权限 多个代码库。如果代码库与虚拟机位于不同的项目中,请向虚拟机服务账号授予 Artifact Registry Reader 角色。
此外,默认服务账号并不具备 API 访问权限范围。
如需设置
cloud-platform
访问权限范围,请执行以下操作:停止虚拟机实例,将
INSTANCE
替换为 虚拟机实例名称。gcloud compute instances stop INSTANCE
设置访问权限范围:
gcloud compute instances set-service-account INSTANCE \ --scopes=cloud-platform
重启虚拟机实例。
gcloud compute instances start INSTANCE
- 用户代管式服务账号
- 如果虚拟机使用用户代管式服务账号,请授予
Artifact Registry Reader 角色授予虚拟机服务账号。
用户代管式服务账号具有
cloud-platform
访问权限范围。
其他虚拟机
向虚拟机服务账号授予 Artifact Registry Reader 角色。默认情况下,用户代管式服务账号具有
cloud-platform
访问权限范围。-
如果您要从 Compute Engine 虚拟机连接到 Apt 代码库,请确保 确保代码库网址包含
ar+
前缀。
凭据帮助程序问题
当虚拟机找不到 Apt 凭据时,系统会显示以下错误消息 帮助程序:
E: Unable to locate package apt-transport-artifact-registry
当您尝试安装 apt-transport-artifact-registry
时
在通过不包含 Apt 的映像创建的虚拟机上创建软件包
代码库签名密钥。
如需解决此问题,请执行以下操作:
在虚拟机上安装签名密钥:
Debian VM
使用以下命令安装 Apt 软件包库签名密钥:
curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo apt-key add -
将
LOCATION
替换为 存储库Ubuntu VM
使用以下命令安装 Apt 软件包库签名密钥:
curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo apt-key add - && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
将
LOCATION
替换为 代码库重新尝试 虚拟机准备步骤。
身份验证插件问题
当 Yum 或 DNF 出现问题时,系统会显示以下错误消息 身份验证插件:
Plugin "artifact-registry" can't be imported
此错误可能是由多种原因造成的。如需解决此错误,请尝试直接运行该插件,以确认依赖项、检查 Python 问题或揭示其他可能的潜在问题。
如需直接运行该插件,请使用以下某个命令:
对于 Yum 插件:
python /usr/lib/yum-plugins/artifact-registry.py
对于 DNF 插件:
python3 /usr/lib/pythonVERSION-NUMBER/site-packages/dnf-plugins/artifact-registry.py
将
VERSION-NUMBER
替换为 Linux 发行版的默认 Python 版本。例如,Enterprise Linux 8 包含 Python 3.6。您可以列出已安装的插件包中的文件,以验证 Python 库目录。
rpm -ql dnf-plugin-artifact-registry|grep artifact-registry.py
缺少最近上传的制品
如果您的 Apt 或 Yum 客户端找不到最近上传的软件包或 可能是因为重新生成 Apt 或 Yum 软件包索引尚未完成。
对于小型代码库,重新生成 Apt 或 Yum 索引文件可能需要 。对于较大的代码库,重新编入索引可能需要几分钟或 。
如需验证软件包是否已成功添加到代码库,请使用 Google Cloud CLI 列出软件包中的文件。运行以下命令:
gcloud artifacts files list \
--package=PACKAGE \
--project=PROJECT-ID \
--repository=REPOSITORY \
--location=LOCATION
例如,您可以检查 python-gflags
软件包是否命名为
已成功将“python3-gflags_1.5.1-5_all.deb
”上传到代码库
us-central1-apt.pkg.dev\apt-project\apt-repo
:
gcloud artifacts files list \
--package=python-gflags \
--project=apt-project \
--repository=apt-repo \
--location=us-central1
如果软件包上传成功,文件会显示在输出中 并在文件名中包含唯一标识符,类似于以下示例:
FILE CREATE_TIME UPDATE_TIME SIZE (MB) OWNER
pool/python3-gflags_1.5.1-5_all_2414c7af6a64c99a5f488aad366d637a.deb 2023-01-12T20:39:53 2023-01-12T20:39:53 0.035 projects/apt-project/locations/us-central1/repositories/apt-repo/packages/python3-gflags/versions/1.5.1-5
某些上传或导入的软件包出现身份验证错误
如果导入或上传文件的时间超出了身份验证令牌的有效期 超过此有效期的上传将失败。令牌的有效期为 60 分钟 。在 Google Cloud 控制台中 导入命令输出。
errors:
- error:
code: 16
message: The request does not have valid authentication credentials.
gcsSource:
uris:
- gs://my-bucket/debs/python/python3-gflags_1.5.1-5_all.deb
要解决此问题,请执行以下操作:
- 请尝试上传或导入特定软件包,以验证您是否可以单独添加该软件包,而不是批量导入。
- 如果多个文件包都上传失败,请分批导入或上传 操作不会超过令牌有效期。