oepkgs共建与未来
个人如何贡献
- 基于PR,创建仓库
在 oepkgs-management 仓库提 PR,填写两个配置文件,PR 合入之后,创仓机器人 ci-robot 会在 src-oepkgs 下面自动创建仓库。
说明:
- oepkgs 仓库将软件包按照领域、类别划分,不同领域及类别的软件包由不同的 sig 组进行维护。
- 开源软件引入 oepkgs 已有 sig 组,提交申请创仓 PR,可基于对应 sig 组的 sig-info.yaml 文件进行修改,不强制要求开源软件引入 oepkgs 仓,需要新建 sig 组。
oepkgs-management 仓库中的两个配置文件,以 nginx 为例,分别是:
- sig-info.yaml
- nginx.yaml
sig-info.yaml 字段解释:
字段 | 解释 | 是否必填 |
---|---|---|
name | sig 组名称,一般跟软件包领域相关 | √ |
description | 对该 sig 的描述 | √ |
mailing_list | sig 组的订阅邮箱地址 | × |
meeting_url | sig 组会议链接 | × |
maintainers | sig 组的管理者,负责该 sig 组下源码仓 PR 的检视与合入 | √ |
repositories | sig 组下面的源码仓 | √ |
committers | sig 组下面某些源码仓的 committers,负责对应仓库 PR 的检视与合入 | √ |
nginx.yaml (仓库配置文件)字段解释:
字段 | 解释 | 是否必填 |
---|---|---|
name | 包名(源码仓名) | √ |
description | 对软件包的描述 | √ |
upstream | 软件包上游仓库地址 | √ |
branches | 仓库分支,oepkgs 镜像源分支管理详见: oepkgs 分支管理文档 | √ |
- 补充源码文件
- 完成步骤一之后,5分钟内会生成 https://gitee.com/src-oepkgs/nginx 仓库,通过 PR 往这个仓库中补充源码文件,分别是可用于支撑生成 rpm 包的 nginx.spec 文件、软件包源码包 nginx-2.12.0.tar.bz2,详见:https://gitee.com/src-oepkgs/nginx 。
说明:
- 提了 PR 之后,在 5~30 分钟时间内,会进行 PR 门禁构建测试,PR 会评论出 PR 构建结果,建议在 Build_Result 显示为 SUCCESS 之后合入 PR。
- 前面配置文件 oepkgs-management/sig/virtual/sig-info.yaml 中指定的 maintanier,可通过在 PR 下面评论 /lgtm 及 /approve 合入 PR。
- 构建
oepkgs 提供一个成熟的 CICD 体系,支撑软件包源码构建,二进制扫描,基本功能验证,保障软件仓库质量可靠及持续演进。
参考资料
未来规划
为更多普通用户和开发者提供服务
- 向用户和开发者开放服务,为更多的人参与及使用。反向促进 oepkgs 服务更加完善。
软件包 patch 管理
- 规划建设软件包 patch 管理系统,增强二进制包安全加固信息展示。检索平台将利用软件包 patch 管理,提供更加全面的二进制包信息,给用户更多检索可能。
持续建设
- 持续建设 openEuler 扩展仓,不断补全生态软件。协同 openEuler 官方仓,共同促进 openEuler 生态发展。
文档捉虫