Manifester

Red Hat订阅已制作清单。

描述

Manifester是一个使用Red Hat订阅管理（RHSM）API动态创建和填充订阅配额并导出订阅清单以便Red Hat Satellite和其他Red Hat产品使用的工具。

安装

克隆此存储库

git clone https://github.com/SatelliteQE/manifester

复制并将manifester_settings.yaml.example文件重命名为manifester_settings.yaml。

需要一个离线令牌来生成离线令牌，该令牌用于通过RHSM API进行身份验证。可以使用RHSM账户的现有离线令牌，或者使用文章入门Red Hat API中的说明生成一个。将离线令牌添加到manifester_settings.yaml。

从清单存储库本地克隆的基目录中，将项目安装到本地Python环境中

pip install .

配置

使用 manifester_settings.yaml 文件通过 DynaConf 来配置 manifester。

manifest_category 部分中可以配置多种类型的清单。这些类型可以根据订阅分配的卫星版本、要添加到清单中的订阅的名称和数量，以及清单上是否启用了 简单内容访问 来区分。

清单中每个订阅的 name 设置值必须与用于生成离线令牌的账户中可用的订阅名称完全匹配。确定账户中可用的订阅名称的一种方法是将系统注册到 RHSM，然后在系统中运行 subscription manager list --available。Manifester 的一个计划中的未来功能是 CLI 命令，它将返回可用订阅的列表。

CLI 使用方法

目前，manifester CLI 支持三个子命令：get-manifest、delete 和 inventory。

get-manifest 子命令用于生成一个保存到 ./manifests 目录的清单。此命令支持两个选项。必需的选项是 --manifest-category，传递给它的值必须在 manifester_settings.yaml 配置文件中定义为清单类别。可选的 --allocation-name 选项可以用来指定在 RHSM 中的订阅分配的名称，该名称将随后成为生成的清单文件名的一部分。如果没有为 --allocation_name 提供值，则将一个由 10 个随机字母字符组成的字符串连接到 manifester_settings.yaml 中 username_prefix 设置的值。第三个选项 --requester 旨在与 Manifester 的单元测试进行未来集成，但目前不支持。示例用法

$ manifester get-manifest --manifest-category <manifest category name> --allocation-name <allocation name>

inventory 子命令用于显示本地清单文件的内容，该文件的路径由 manifester_settings.yaml 中的 inventory_path 设置指定。在不带选项的情况下执行 manifester inventory 将将一个表格写入标准输出，其中包含用户创建的每个订阅分配的名称和每个分配的清单索引号。传递 --details 选项将打印由 RHSM API 返回的分配的附加详细信息。传递 --sync 选项将在打印清单之前从 RHSM API 更新清单。**注意**：清单是基于以 manifester_settings.yaml 中定义的 username_prefix 开头的名称开始的 RHSM 账户中的订阅分配生成的。因此，维护一个唯一且一致的 username_prefix（例如用户的 RHSM 账户用户名）对于准确的清单管理至关重要。示例用法和输出

$ manifester inventory
[I 240320 14:52:02 commands:78] Displaying local inventory data
--------------------------------------
| Index | Allocation Name            |
--------------------------------------
| 0     | user-mBIojPMF              |
--------------------------------------
$ manifester inventory --details
[I 240320 14:52:42 commands:86] Displaying detailed local inventory data
0:
    entitlementQuantity: 4
    name: user-mBIojPMF
    simpleContentAccess: enabled
    type: Satellite
    url: https://api.access.redhat.com/management/v1/allocations/2ea75142-8ea4-46db-87e3-1feab8613000
    uuid: 2ef73132-83a4-473b-97e3-1feab8623000
    version: 6.14

delete 子命令将从 RHSM 中删除清单中的订阅分配，并且可选地删除与这些分配相关的本地清单文件。delete 子命令将接受库存索引号列表或订阅分配名称列表。或者，可以使用 --all 选项删除清单中的所有订阅分配。传递 --remove-manifest-file 选项将导致 CLI 除了从 RHSM 中删除订阅分配外，还将从本地文件系统中删除任何已删除订阅分配的清单文件。示例用法

$ manifester delete 0 1 2
$ manifester delete user-mBIojPMF
$ manifester delete --all