从零开始：使用openEuler OpenStack SIG工具创建RPM软件仓的完整指南

【免费下载链接】openstackIssue report and discussion entry repo for OpenStack SIG项目地址: https://gitcode.com/openeuler/openstack

前往项目官网免费下载：https://ar.openeuler.org/ar/

在openEuler生态系统中，OpenStack SIG（特别兴趣小组）提供了一套强大的工具链，专门用于简化RPM软件包的创建和管理流程。对于想要为openEuler社区贡献软件包的开发者来说，掌握这些工具是提高效率的关键。本文将为您详细介绍如何使用openEuler OpenStack SIG工具创建RPM软件仓，帮助您快速上手并参与到开源社区的贡献中。

🚀 什么是openEuler OpenStack SIG工具？

openEuler OpenStack SIG工具（简称oos）是一个专门为OpenStack SIG开发者设计的命令行工具集，旨在简化RPM软件包的创建、更新和管理流程。这个工具集包含了多个实用功能，能够显著降低开发者的工作负担。

核心功能包括：

• 自动生成和更新RPM Spec文件
• 分析OpenStack软件包依赖关系
• 自动提交Spec PR到openEuler社区
• 获取OpenStack SIG CI失败的PR列表
• 为软件仓创建和删除分支

📦 环境准备与安装

在开始使用openEuler OpenStack SIG工具之前，您需要准备好基础环境。首先确保您的系统已经安装了必要的软件包：

# 安装基础依赖 dnf install rpm-build rpmdevtools git # 设置RPM构建环境 rpmdev-setuptree # 安装openstack-sig-tool pip install openstack-sig-tool==1.0.6

注意：openstack-sig-tool在1.1.0版本对oos spec命令进行了重构。如果您使用的是较新版本，请参考对应的文档说明。

🔑 获取Gitee个人访问令牌

要使用openEuler OpenStack SIG工具的自动化功能，您需要生成Gitee的个人访问令牌（PAT）。这是与openEuler社区仓库进行交互的凭证。

首先登录Gitee，进入"设置"界面：

选择"私人令牌"选项，然后点击"生成新令牌"。请务必妥善保存生成的令牌，因为Gitee不会再次显示它。

🛠️ 使用oos工具创建RPM Spec

openEuler OpenStack SIG工具的核心功能之一是自动生成RPM Spec文件。让我们以升级python-pyrsistent软件包为例，演示完整的流程。

1. 生成Spec文件并提交PR

# 设置环境变量 export GITEE_PAT=<your_gitee_pat> # 生成Spec并自动提交PR oos spec push --name python-pyrsistent --version 0.18.1 -dp

参数说明：

• --name：软件包名称（对应项目名称）
• --version：目标版本号
• -dp, --do-push：自动提交到Gitee仓库并创建PR

2. oos spec push命令的执行流程

oos spec push命令会自动执行以下步骤：

1. 自动fork仓库：将指定仓库fork到您的Gitee账户
2. 克隆到本地：默认路径为~/rpmbuild/src-repos
3. 下载源码并生成Spec：根据指定的名称和版本下载源码包，生成Spec文件
4. 本地构建测试：在本地运行RPM包构建测试
5. 自动提交：如果指定了-dp参数，会自动push并创建PR

3. 处理构建失败的情况

如果本地构建失败，您可以修改生成的Spec文件，然后重新执行：

oos spec push --name python-pyrsistent --version 0.18.1 -dp -rs

使用-rs参数可以复用已存在的Spec文件，不再重新生成。

🔍 PR门禁检查与处理

当您提交PR后，openEuler的CI系统会自动进行门禁检查。您可以在自己的Gitee账户中查看fork过来的仓库，并通过以下方式访问原仓库：

在原仓库中，您可以看到自动提交的PR。openeuler-ci-bot会在PR中添加评论，显示门禁检查结果：

如果门禁检查失败，您可以点击"build details"查看详细的构建日志，根据错误信息修改Spec文件，然后重新执行oos spec push命令。

📊 依赖分析功能

openEuler OpenStack SIG工具还提供了强大的依赖分析功能，这对于处理复杂的OpenStack软件包依赖关系非常有用。

生成依赖分析结果

# 生成OpenStack Train版本的依赖缓存文件 cd tools/oos/scripts python3 generate_dependence.py train # 生成特定项目的依赖分析 python3 generate_dependence.py --projects nova,cinder train # 使用oos命令生成依赖分析结果 oos dependence generate train_cached_file

版本比对功能

您可以使用oos dependence compare命令比较不同openEuler分支的软件包版本：

oos dependence compare 2023.1_cached_file -b 'master openEuler-23.03' -o my_result -r antelope

这个命令会生成一个CSV格式的结果文件，显示每个软件包在不同分支上的版本状态。

📈 批量处理软件包

openEuler OpenStack SIG工具支持批量处理多个软件包，这对于大规模升级或迁移工作非常有用。

批量创建软件仓

# 创建单个软件仓 oos repo create --repo autopage:python-autopage -t GITEE_PAT # 批量创建软件仓（使用CSV文件） oos repo create --repos-file ~/repos.csv -t GITEE_PAT

批量创建分支

# 为单个软件仓创建分支 oos repo branch-create --repo openstack-nova -b openEuler-21.09 protected master -t GITEE_PAT # 批量创建多个分支 oos repo branch-create --repos-file repos.csv -b openEuler-21.09 protected master -b openEuler-22.03-LTS protected openEuler-22.03-LTS-Next -t GITEE_PAT --do-push

🐛 常见问题与解决方案

在使用openEuler OpenStack SIG工具过程中，您可能会遇到一些常见问题。以下是一些解决方案：

1. 测试未执行问题

oos自动生成的Spec文件中，%check部分默认为%{__python3} setup.py test。但在某些情况下，这并不会真正执行测试。您可以通过以下方法检查：

如果发现测试没有实际执行，可以参考仓库中现有的Spec文件，修改%check部分的测试命令。

2. 包名不一致问题

有时会遇到包名不一致的情况（如使用-和下划线_的差异）。在这种情况下，应该以原有包名为准，不修改原有包名。您可以手动将Spec文件中的相关部分改为原有包名。

3. 依赖环问题

在处理复杂的Python依赖时，可能会遇到依赖环问题。openEuler OpenStack SIG工具通过引入core核心概念来避免这个问题，用户可以根据需求选择要分析的软件范围。

🎯 最佳实践建议

1. 遵循SIG规范

在创建RPM软件包时，请确保遵循OpenStack SIG的规范要求。这些规范详细定义了软件包的结构、命名规则和构建流程。

2. 充分利用自动化工具

openEuler OpenStack SIG工具提供了丰富的自动化功能，建议充分利用这些功能来提高工作效率：

• 使用oos spec push自动生成和提交Spec文件
• 使用oos dependence分析依赖关系
• 使用批量操作处理多个软件包

3. 及时处理门禁反馈

当PR提交后，密切关注门禁检查结果。如果构建失败，及时查看详细日志并修复问题。

4. 参与社区协作

OpenStack SIG是一个活跃的社区，建议积极参与社区讨论和代码审查。这不仅有助于提高您的技能，也能为社区做出更多贡献。

📚 相关资源与文档

要深入了解openEuler OpenStack SIG工具的更多功能和使用方法，可以参考以下资源：

• 官方文档：docs/spec/openstack-sig-tool.md
• RPM打包参考：docs/contribute/rpm-packaging-reference.md
• 工具源码：tools/oos/
• Docker环境：tools/docker/README.md

🎉 开始您的贡献之旅

通过本文的介绍，您已经了解了如何使用openEuler OpenStack SIG工具创建RPM软件仓。现在，您可以开始您的开源贡献之旅了！

记住，开源社区的成长离不开每一位贡献者的努力。无论您是经验丰富的开发者还是刚刚入门的新手，openEuler OpenStack SIG都欢迎您的加入。从创建一个简单的RPM包开始，逐步参与到更复杂的项目开发中，您会发现开源世界的无限魅力。

如果您在过程中遇到任何问题，不要犹豫，在社区中寻求帮助。openEuler社区有热情的维护者和开发者，他们很乐意帮助新人成长。

立即行动：选择一个您感兴趣的软件包，尝试使用openEuler OpenStack SIG工具创建或更新它的RPM包吧！🚀

祝您在openEuler社区的贡献之旅顺利愉快！

【免费下载链接】openstackIssue report and discussion entry repo for OpenStack SIG项目地址: https://gitcode.com/openeuler/openstack