relvalconsumer 2.2.1

# relvalconsumer

relvalconsumer是一个用于创建Fedora发布验证测试事件的fedora-messaging consumer。每次出现新的组合时，它会运行各种检查以决定是否为组合创建事件。它为夜间组合和“候选人”组合都创建事件。

它应该在发布发布后不久创建下一个发布的第一夜。从那时起直到发布，它将定期创建新的夜间事件。它永远不会在当前事件后三天内创建夜间事件。在当前事件后三天到十四天之间，如果某些包已更改（这些在代码中定义），它将创建新的事件。在十四天后，一旦出现夜间组合，它将创建事件。它将一出现就为所有候选人组合创建事件。

在发布分支之后，它永远不会为给定的发布从Rawhide组合创建事件，因为在那一刻，wikitcms将决定任何关于Rawhide组合的事件都是针对当前稳定发布后的第二个发布，而这个脚本只会为当前稳定发布后的第一个发布创建事件。

请注意，在生产模式下，消费者被配置为在生产wiki中创建事件并向test@邮件列表发送公告邮件。所以，实际上，只有一个人应该在生产模式下运行它，那可能是我。除非你接管我的工作或其他事情，否则请不要在生产模式下运行它。

只要relval也安装了，relvalconsumer将在创建事件时对新生成的事件运行图像大小检查。

该项目还包括另一个消费者，RelvalAMIConsumer，当从fedimg（将Fedora AMI镜像发布到EC2的工具）收到相关的“AMI发布”消息时，它会更新包含可用EC2 AMI信息的维基页面。

## 需求

Python库

• [fedora-messaging](https://github.com/fedora-infra/fedora-messaging)

• [fedfind](https://pagure.io/fedora-qa/fedfind)

• [wikitcms](https://pagure.io/fedora-qa/python-wikitcms)

• [mwclient](https://github.com/mwclient/mwclient)

还需要 hawkey 库。这个库仅在Fedora和RHEL上可用，并且只能从官方软件仓库获取，不能从Pypi获取。

可选地，还可以使用 [relval](https://pagure.io/fedora-qa/relval) 本身，在创建的事件上运行图像大小检查测试。

## 安装

安装所需的Python库，然后使用setuptools进行安装，例如：

python3 setup.py install

通常还需要做：

dnf install fedora-messaging python3-hawkey

## 配置

提供了一个示例配置文件，该文件配置为在生产fedora-messaging总线上监听真实组合事件，文件名为 relvalconsumer.toml。AMI消费者提供的示例文件为 relvalamiconsumer.toml。要使用这些文件，您至少需要将队列名称从 00000000-0000-0000-0000-000000000000 更改为唯一的私有字符串；官方建议使用uuidgen生成的UUID。然后将其放置在 /etc/fedora-messaging。

然后，您可以将消费者作为systemd服务启用并启动

sudo systemctl enable fm-consumer@relvalconsumer sudo systemctl start fm-consumer@relvalconsumer

对于AMI消费者

sudo systemctl enable fm-consumer@relvalamiconsumer sudo systemctl start fm-consumer@relvalamiconsumer

## 测试和生产模式

配置设置 relval_prod 决定消费者是否在“生产”或“测试”模式下运行。这设置在消费者配置文件的 consumer_config 部分。AMI消费者的相应设置为 relvalami_prod。在测试模式下：

• 消费者在预演维基（而非生产维基）上创建事件

• 记录公告电子邮件而不是发送电子邮件

在这种模式下，可以相对安全地与消费者交互。不过，您需要本地fedora-messaging代理实例才能随意触发消费者。根据您的设置，您可能还需要将 routing_keys 从 .prod. 更改为 .dev. 或类似。

对于“生产”

• 消费者在生产维基上创建事件

• 消费者向公共邮件列表发送电子邮件通知

请不要启用生产消费者，除非您绝对确定创建官方事件是您的职责。

## 许可证

relvalconsumer 在GPL版本3或更高版本下发布。请参阅 COPYING 和 relvalconsumer.py 文件的标题。

## 贡献

可以在 [Pagure](https://pagure.io/fedora-qa/relvalconsumer) 中提交问题和pull请求。pull请求必须签署（使用git的 -s 参数）。通过签署您的pull请求，您同意 [开发者证书来源](http://developercertificate.org/)

开发者证书来源 1.1

通过向本项目做出贡献，我证明

1. 贡献是在我完全或部分创建的，并且我有权在文件中提交它；或者

2. 本贡献基于先前的作品，据我所知，这些作品在适当的开源许可下受到保护，并且我有权根据该许可对作品进行修改并提交，无论这些修改是全部或部分由我创建的，都应遵守相同的开源许可（除非我被允许使用不同的许可），如文件中所示；或者

3. 该贡献直接由某个人提供给我，该人已证明（a）、（b）或（c），并且我没有对其进行修改。

4. 我理解和同意，本项目和贡献是公开的，贡献的记录（包括我提交的所有个人信息，包括我的签名）将无限期保留，并且可以按照本项目或相关的开源许可证进行重新分发。