当前位置：首页 > news >正文

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

news 2026/7/15 17:39:36

从零开始：使用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命令会自动执行以下步骤：

自动fork仓库：将指定仓库fork到您的Gitee账户
克隆到本地：默认路径为~/rpmbuild/src-repos
下载源码并生成Spec：根据指定的名称和版本下载源码包，生成Spec文件
本地构建测试：在本地运行RPM包构建测试
自动提交：如果指定了-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