3.7. 典型的客户端 RPM 工作流

流程

1. 在以下示例中，您将在 x86_64 架构中为客户端配置 RPM 为 Red Hat Enterprise Linux 8 创建自定义软件仓库：

   # rhui-manager repo create_custom --protected --repo_id client-config-rhel-8-x86_64 --display_name "RHUI Client Configuration for RHEL 8 on x86_64" --gpg_public_keys /root/RPM-GPG-KEY-my-cloud

   Copy to Clipboard Toggle word wrap

   如果需要，您可以使用不同的存储库 ID 并显示名称，并确保您指定实际的 GPG 密钥文件。

2. 添加相关的红帽软件仓库。以下 YAML 文件包含 x86_64 架构上用于基本 Red Hat Enterprise Linux 8 的典型存储库集合，使用未指定版本的软件仓库：

   # cat rhel-8-x86_64.yaml
   name: Red Hat Enterprise Linux 8 on x86_64
   repo_ids:
     - codeready-builder-for-rhel-8-x86_64-rhui-debug-rpms-8
     - codeready-builder-for-rhel-8-x86_64-rhui-rpms-8
     - codeready-builder-for-rhel-8-x86_64-rhui-source-rpms-8
     - rhel-8-for-x86_64-appstream-rhui-debug-rpms-8
     - rhel-8-for-x86_64-appstream-rhui-rpms-8
     - rhel-8-for-x86_64-appstream-rhui-source-rpms-8
     - rhel-8-for-x86_64-baseos-rhui-debug-rpms-8
     - rhel-8-for-x86_64-baseos-rhui-rpms-8
     - rhel-8-for-x86_64-baseos-rhui-source-rpms-8
     - rhel-8-for-x86_64-supplementary-rhui-debug-rpms-8
     - rhel-8-for-x86_64-supplementary-rhui-rpms-8
     - rhel-8-for-x86_64-supplementary-rhui-source-rpms-8

   Copy to Clipboard Toggle word wrap

   要使用上述 YAML 文件添加并同步所有这些软件仓库，请运行以下命令：

   # rhui-manager repo add_by_file --file rhel-8-x86_64.yaml --sync_now

   Copy to Clipboard Toggle word wrap

3. 创建权利证书。您需要证书允许的存储库标签列表。存储库标签通常与存储库 ID 相同，但当存储库 ID 包含特定的 Red Hat Enterprise Linux 次版本时，在这种情况下，标签不包含次版本，而只是主版本。对于基本 Red Hat Enterprise Linux 软件仓库，ID 是相同的，因此您可以使用以下 Python 代码从上述 YAML 文件中提取它们：

   import yaml
   with open("rhel-8-x86_64.yaml") as repoyaml:
       repodata = yaml.safe_load(repoyaml)
       print(",".join(repodata["repo_ids"]))

   Copy to Clipboard Toggle word wrap

   将输出复制到剪贴板中，并将它保存为环境变量；例如，$labels：

   # labels=<paste the contents of the clipboard here>

   Copy to Clipboard Toggle word wrap

   除了 Red Hat Enterprise Linux 存储库标签外，您还需要在创建授权证书时将自定义存储库添加到以逗号分隔的标签列表中。运行以下命令来创建授权证书，允许访问 Red Hat Enterprise Linux 软件仓库和自定义软件仓库：

   # rhui-manager client cert --name rhel-8-x86_64 --dir /root --days 3650 --repo_label $labels,client-config-rhel-8-x86_64

   Copy to Clipboard Toggle word wrap

   如果您的公司的策略只允许证书有效期为一年、两年等，请相应地更改- 天 参数的值。

   这个命令创建文件 /root/rhel-8-x86_64.crt 和 /root/rhel-8-x86_64.key。下一步您将需要它们。

4. 创建客户端配置 RPM：

   # rhui-manager client rpm --dir /tmp --rpm_name rhui-client-rhel-8-x86_64 --rpm_version 1.0 --entitlement_cert /root/rhel-8-x86_64.crt --private_key /root/rhel-8-x86_64.key

   Copy to Clipboard Toggle word wrap

   使用您选择的 RPM 名称或版本。使用以上值时，命令会创建 RPM 并显示其位置，即：

   /tmp/rhui-client-rhel-8-x86_64-1.0/build/RPMS/noarch/rhui-client-rhel-8-x86_64-1.0-1.noarch.rpm

5. 将这个 RPM 从 RHUA 传送到您的系统，并使用与您在创建自定义存储库时用作-- gpg_public_keys 参数的公钥对应的相应 GPG 密钥进行签名。例如，您可以在云环境中的 Red Hat Enterprise Linux 8 x86_64 镜像上预安装了签名的 RPM。您还需要将签名的 RPM 传送到 RHUA，并将其上传到 x86_64 上 Red Hat Enterprise Linux 8 的自定义软件仓库：

   # rhui-manager packages upload --repo_id client-config-rhel-8-x86_64 --packages /root/signed/rhui-client-rhel-8-x86_64-1.0-1.noarch.rpm

   Copy to Clipboard Toggle word wrap

验证

1. 检查自定义存储库的内容：

   # rhui-manager packages list --repo_id client-config-rhel-8-x86_64

   Copy to Clipboard Toggle word wrap

   此命令应该打印您上传的 RPM 文件。

2. 配置了 CDS 和 HAProxy 节点（在本指南中稍后描述）后，您还可以在测试虚拟机上安装客户端配置 RPM，并在测试虚拟机上运行以下命令来验证访问所有相关存储库：

   # yum -v repolist

   Copy to Clipboard Toggle word wrap

   此命令应该打印配置的 Red Hat Enterprise Linux 8 软件仓库和用于客户端配置 RPM 的自定义存储库。

1. 如果您在之前的调用中使用了 1.0，请立即使用如 2.0，并保留其余参数：

   # rhui-manager client rpm --dir /tmp --rpm_name rhui-client-rhel-8-x86_64 --rpm_version 2.0 ...

   Copy to Clipboard Toggle word wrap

2. 然后，为较新的 RPM 签名，将其传送到 RHUA，并将其上传到自定义存储库中：

   # rhui-manager packages upload --repo_id client-config-rhel-8-x86_64 --packages /root/signed/rhui-client-rhel-8-x86_64-2.0-1.noarch.rpm

   Copy to Clipboard Toggle word wrap
3. 安装之前版本的 RPM 的客户端虚拟机现在可以更新到更新的版本。请注意，可能需要清理客户端虚拟机上 dnf 缓存，使 dnf 重新加载 repodata，这是在上传较新的 RPM 时进行更新。