配置虚拟机以安装 RPM 软件包

本页面介绍如何配置虚拟机以从 Artifact Registry Yum 代码库安装 RPM 软件包。Artifact Registry Yum 代码库支持 yum 和 dnf 客户端。

准备工作

如果目标 Yum 代码库不存在， 请创建新代码库。您可以创建私有代码库，也可以创建不需要身份验证的公共代码库。

准备虚拟机以访问 Yum 代码库

如需准备虚拟机以访问 Yum 代码库，请使用 yum 或 dnf 客户端工具：

私有代码库

  1. 选择您将用于授予访问权限的服务帐号。

    • 对于 Compute Engine 虚拟机，这可能是 默认服务账号。 Artifact Registry 会自动检索使用服务帐号的任何虚拟机的 Compute Engine 虚拟机服务帐号凭据。
    • 对于其他虚拟机，请创建 或选择一个服务帐号以代表您的虚拟机执行操作。您需要服务帐号密钥文件所在的位置，才能配置虚拟机。您 可以在 “服务账号”页面上查看和创建现有账号的密钥。

  2. 向您的服务帐号授予代码库访问权限

  3. 准备虚拟机以访问代码库。

    Compute Engine 虚拟机

    1. 向虚拟机分配 cloud-platform API 访问权限范围 。如需了解如何设置访问权限 范围，请参阅 更改实例的服务帐号和访问权限范围。

    2. 使用以下命令更新软件包缓存：

      sudo yum makecache

    3. 使用以下命令在虚拟机上安装 Artifact Registry 插件：

      sudo yum install FORMAT-plugin-artifact-registry

      替换以下内容：

      • 将 FORMAT 替换为以下项之一：
        • 如果您的操作系统是 Enterprise Linux 7 或更早版本，请替换为 yum
        • 如果您的操作系统是 Enterprise Linux 8 或更高版本，请替换为 dnf

    其他虚拟机

    1. 使用以下命令安装 RPM 签名密钥：

      sudo rpm --import https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg

    2. 创建一个名为 /etc/yum.repos.d/artifact-registry-plugin.repo 的文件，其中包含以下内容：

      [ar-plugin]
name=Artifact Registry Plugin
baseurl=https://packages.cloud.google.com/yum/repos/FORMAT-plugin-artifact-registry-DISTRO-stable
enabled=1
gpgcheck=1

      替换以下内容：

      • 将 FORMAT 替换为以下项之一：
        • 如果您的操作系统是 Enterprise Linux 7 或更早版本，请替换为 yum
        • 如果您的操作系统是 Enterprise Linux 8 或更高版本，请替换为 dnf
      • 将 DISTRO 替换为 Red Hat Enterprise Linux 主要版本，格式为 elX，其中 X 是版本 号。有效的 DISTRO 值示例包括 el7 和 el8。

    3. 使用以下命令更新 Yum：

      sudo yum makecache

    4. 使用以下命令在虚拟机上安装 Artifact Registry 插件：

      yum install FORMAT-plugin-artifact-registry

      将 FORMAT 替换为以下项之一：

      • 如果您的操作系统是 Enterprise Linux 7 或更早版本，请替换为 yum
      • 如果您的操作系统是 Enterprise Linux 8 或更高版本，请替换为 dnf

    5. 在 artifact-registry.conf 文件中找到 #service_account_json = "/path/to/creds.json" 行，然后取消该行的注释并添加服务帐号密钥的路径。

      • 对于 Enterprise Linux 7 或更早版本的操作系统，配置文件的路径为 /etc/yum/pluginconf.d/artifact-registry.conf。
      • 对于 Enterprise Linux 8 或更高版本的操作系统，配置文件的路径为 /etc/dnf/plugins/artifact-registry.conf。

      配置文件条目：

      service_account_json = "PATH_TO_SERVICE_ACCOUNT_KEY"

      将 PATH_TO_SERVICE_ACCOUNT_KEY 替换为服务帐号密钥 JSON 文件的路径。

公共代码库

配置对代码库的公共访问权限 。

配置虚拟机以访问标准 Yum 代码库

如需配置虚拟机以访问 Yum 代码库，请使用 yum 或 dnf 客户端工具：

  1. 运行 gcloud beta artifacts print-settings yum 命令，生成虚拟机配置命令：

    gcloud beta artifacts print-settings yum \
    --repository=REPOSITORY \
    --location=LOCATION

    替换以下内容：

    • REPOSITORY 是 Artifact Registry 代码库的名称。
    • LOCATION 是代码库的区域 位置。

    输出类似于以下内容：

    # To configure your package manager with this repository:

# Update Yum:
sudo yum makecache

# Install the Yum credential helper:
sudo yum install yum-plugin-artifact-registry

# Configure your VM to access Artifact Registry packages using the following
# command:

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL
[REPOSITORY]
name=REPOSITORY
baseurl=https://LOCATION-yum.s3nsregistry.fr/projects/PROJECT/REPOSITORY
enabled=1
repo_gpgcheck=0
gpgcheck=0
EOL

# Update Yum:
sudo yum makecache

  2. 使用 print-settings 命令输出中的 tee 命令，将 yum 客户端工具配置为从您的代码库提取软件包。

    例如，如需从项目 my-project中位置为 u-france-east1 的公共 my-repo 安装软件包，请使用以下命令：

    sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL
[my-repo]
name=My Repository
baseurl=https://u-france-east1-yum.s3nsregistry.fr/projects/my-project/my-repo
enabled=1
repo_gpgcheck=0
gpgcheck=0
EOL

  3. 使用以下命令更新代码库来源：

    sudo yum makecache

Yum 现在可以连接到代码库。

如果您创建其他 Yum 代码库，请在 /etc/yum.repos.d/ 中为每个代码库创建一个 .repo 文件 。重新运行 sudo yum update 以更新代码库来源。

后续步骤