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

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

准备工作

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

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

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

配置虚拟机以访问标准 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.pkg.dev/projects/PROJECT/REPOSITORY
   enabled=1
   repo_gpgcheck=0
   gpgcheck=0
   EOL
   
   # Update Yum:
   sudo yum makecache
   

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

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

   sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL
   [my-repo]
   name=My Repository
   baseurl=https://us-west1-yum.pkg.dev/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 以更新代码库来源。

配置虚拟机以访问远程 Yum 代码库

如需将虚拟机配置为仅使用远程 Yum 代码库，而不是标准上游 Yum 代码库，请将虚拟机代码库列表中的标准代码库替换为远程代码库。

如果标准代码库是在配置文件中定义的，而不是在单独的代码库文件 (.repo) 中定义的，您可以删除配置文件中的条目并将其替换为远程代码库，也可以在 /etc/yum.repos.d/ 目录中定义新的代码库文件。

1. 转到 “虚拟机实例”页面。

2. 在虚拟机所在的行中，点击 SSH 。系统会打开一个新窗口，其中包含虚拟机上的终端会话。

3. 打开虚拟机的 /etc/yum.repos.d/ 文件夹，找到包含标准上游代码库的相应 代码库文件 (.repo)。 这有时称为基本代码库。基本代码库可以通过包含 [base] 或 [baseos] 的 Yum 代码库名称来识别。

4. 如需完全替换基本代码库，请移除 [base] 或 [baseos] 下的默认设置。如果您想保留标准上游代码库并将远程代码库添加为回退选项，请不要移除默认设置。

5. 在 [base] 或 [baseos] 下添加以下设置：

   name=YUM_REPOSITORY_NAME
   baseurl=https://LOCATION-yum.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME
   enabled=1
   gpgcheck=1
   

   替换以下内容：

• 将 YUM_REPOSITORY_NAME 替换为远程 Yum 代码库的唯一单字代码库 ID。如果您已删除标准上游代码库配置，或者如果您保留标准上游代码库，则此名称可以与上游代码库名称匹配，也可以使用其他名称将其标识为远程代码库。
• LOCATION 是代码库的区域或多区域 位置。
• 将 PROJECT_ID 替换为虚拟机的项目 ID。
• 将 REMOTE_REPOSITORY_NAME 替换为远程代码库的直观易懂的名称。

将远程 Yum 代码库用作备份

如果您想将标准上游代码库保留为首选选项，并将远程代码库添加为回退选项，则可以将标准上游代码库保留在代码库文件中，并在 /etc/yum.repos.d 文件夹中创建新的代码库文件。

如需在 /etc/yum.repos.d 文件夹中创建新的代码库文件，请运行以下命令：

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
[YUM_REPOSITORY_NAME]
name=REPOSITORY_NAME
baseurl=https://LOCATION-yum.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME
enabled=1
gpgcheck=1
EOF

替换以下内容：

• 将 YUM_REPOSITORY_NAME 替换为远程 Yum 代码库的唯一单字代码库 ID。
• 将 REPOSITORY_NAME 替换为代码库的直观易懂的名称。
• 将 LOCATION 替换为远程代码库的区域或多区域 位置。
• 将 PROJECT_ID 替换为虚拟机的项目 ID。
• 将 REMOTE_REPOSITORY_NAME 替换为您为远程代码库指定的名称。

例如，以下命令会将虚拟机配置为在 Yum 安装 代码库 my-repo 时提取项目 my-project 中位置为 us-west1 的代码库 my-repo。

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
[my-repo]
name=My Repository
baseurl=https://us-west1-yum.pkg.dev/remote/my-project/my-repo
enabled=1
gpgcheck=1
EOF

后续步骤

• 了解如何管理软件包