排查操作系统软件包问题

了解以下可能会对您有所帮助的问题排查步骤 如何在 Artifact Registry 中管理操作系统软件包时遇到问题。

了解如何解决 Artifact Registry Remote 相关问题 操作系统软件包的代码库,请参阅 排查远程仓库问题

身份验证和权限问题

您无法连接到代码库执行安装软件包等操作。软件包管理器的输出包含 401403 错误, 表示身份验证或权限存在问题。

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

导致这些错误的原因有很多。确保您的虚拟机符合以下要求:

  1. 验证虚拟机是否具有关联的服务账号。

    Compute Engine 虚拟机

    1. 转到虚拟机实例页面。
    2. 在虚拟机列表中,点击虚拟机的名称。

      详细信息标签页的 API 和身份管理下方,会显示服务账号和访问权限范围。

    默认情况下,Compute Engine 虚拟机使用 Compute Engine 默认服务账号,并且具有一组有限的访问范围。默认服务账号电子邮件地址的格式为 PROJECT_NUMBER-compute@developer.gserviceaccount.com

    如需更改服务账号或将服务账号附加到虚拟机,请参阅 更改实例的服务账号和访问权限范围

    其他虚拟机

    对于其他虚拟机,您必须拥有一个服务账号来代表该虚拟机执行操作。

    1. 创建一个服务账号(如果您还没有服务账号)。

    2. 在创建服务账号时授予 Artifact Registry Reader (roles.artifactregistry.reader) 角色,这样您就不必在单独的步骤中配置权限。

  2. 确保虚拟机服务账号拥有对代码库的读取权限以及 cloud-platform API 访问权限范围。

    Compute Engine 虚拟机

    Artifact Registry 会自动检索虚拟机服务账号凭据。通过 取决于您是否使用默认 服务账号或用户代管式服务账号。

    默认服务账号

    如果虚拟机使用默认服务账号,则此服务 账号默认具有“编辑者”角色,其中包括读取权限 多个代码库。如果代码库与虚拟机位于不同的项目中,请向虚拟机服务账号授予 Artifact Registry Reader 角色。

    此外,默认服务账号并不具备 API 访问权限范围。

    如需设置 cloud-platform 访问权限范围,请执行以下操作:

    1. 停止虚拟机实例,将 INSTANCE 替换为 虚拟机实例名称。

      gcloud compute instances stop INSTANCE
      
    2. 设置访问权限范围:

      gcloud compute instances set-service-account INSTANCE \
          --scopes=cloud-platform
      
    3. 重启虚拟机实例。

      gcloud compute instances start INSTANCE
      
    用户代管式服务账号
    如果虚拟机使用用户代管式服务账号,请授予 Artifact Registry Reader 角色授予虚拟机服务账号。 用户代管式服务账号具有 cloud-platform 访问权限范围。

    其他虚拟机

    向虚拟机服务账号授予 Artifact Registry Reader 角色。默认情况下,用户代管式服务账号具有 cloud-platform 访问权限范围。

  3. 确认您已按照相应步骤准备好虚拟机以访问代码库。请参阅 AptYum 准备说明。

  4. 确认您已正确配置 AptYum 用于访问代码库。

    如果您要从 Compute Engine 虚拟机连接到 Apt 代码库,请确保 确保代码库网址包含 ar+ 前缀。

凭据帮助程序问题

当虚拟机找不到 Apt 凭据时,系统会显示以下错误消息 帮助程序:

E: Unable to locate package apt-transport-artifact-registry

当您尝试安装 apt-transport-artifact-registry 时 在通过不包含 Apt 的映像创建的虚拟机上创建软件包 代码库签名密钥。

如需解决此问题,请执行以下操作:

  1. 在虚拟机上安装签名密钥:

    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 替换为 代码库

  2. 重新尝试 虚拟机准备步骤

身份验证插件问题

当 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

要解决此问题,请执行以下操作:

  1. 请尝试上传或导入特定软件包,以验证您是否可以单独添加该软件包,而不是批量导入。
  2. 如果多个文件包都上传失败,请分批导入或上传 操作不会超过令牌有效期。