openEuler社区软件包引入到各版本分支原则 1、软件包引入master保护分支，通过tc委员会及对应sig组review、approve即可； 2、软件包从master分支引入到openEuler其他保护分支，需通过tc委员会、对应sig组、以及release managerment sig集体review、approve后可集成到对应版本分支中；

下图简要介绍具体操作流程 ！软件包分支变更权限控制

一、创建新软件仓库

新建软件仓库分为两种：新建原创软件 upstream开源仓库，新引入其他开源社区开源软件源码仓库。

原创开源软件，选择openEuler作为upstream托管仓库，对应的PR创建流程如下：

• a) 原创开源软件加入openEuler社区已有sig组，提交申请建仓PR，TC 及对应sig组review approve后既可自动创建gitee软件仓（CI脚本自动触发），同时CI脚本会自动触发在OBS的factory编译工程中创建预验证工程；

• PR示例：https://gitee.com/openeuler/community/pulls/1226/files

• b) 原创开源软件申请新的sig组，提交申请建仓PR，TC 及对应sig组review approve后既可自动创建gitee软件仓（CI脚本自动触发），同时CI脚本会自动触发在OBS的factory编译工程中创建预验证工程；

• PR示例：https://gitee.com/openeuler/community/pulls/1280/files

开源软件引入openEuler社区，作为openEuler社区版本rebuild构建使用，对应的PR创建流程样例如下：

• a) 开源软件加入openEuler社区已有sig组，提交申请建仓PR，TC 及对应sig组review approve后既可自动创建gitee软件仓（CI脚本自动触发），同时CI脚本会自动触发在OBS的factory编译工程中创建预验证工程；

• PR示例：https://gitee.com/openeuler/community/pulls/975/files

• b) 开源软件申请新的sig组，提交申请建仓PR，TC 及对应sig组review approve后既可自动创建gitee软件仓（CI脚本自动触发），同时CI脚本会自动触发在OBS的factory编译工程中创建预验证工程；

• PR示例：https://gitee.com/openeuler/community/pulls/1251/files

二、代码上传到gitee社区

建仓完成后，根据openEuler社区打包规范,完成软件包spec撰写/适配，之后新建PR提交代码+spec等完整的包文件，通过门禁检查和单包编译检查

• PR示例：https://gitee.com/src-openeuler/isula-build/pulls/1

三、代码编译构建二进制RPM包（OBS构建工程）

在第二步骤中新包在OBS的factory工程下编译成功且稳定后，就可以申请移仓到OBS mainline或者其他master下编译工程中来了，申请PR样例如下（openEuler社区是共主干开发，mainline是不受限新增包，编译成功稳定就可以申请加入mainline工程或者其他工程）

• master包含以下工程：openEuler:Factory,openEuler:Mainline,openEuler:Epol,openEuler:BaseTools,openEuler:C,openEuler:Common_Languages_Dependent_Tools,openEuler:Epol,openEuler:Erlang,openEuler:Golang,openEuler:Java,openEuler:KernelSpace,openEuler:Lua,

openEuler:Meson,openEuler:MultiLanguage,openEuler:Nodejs,openEuler:Ocaml,openEuler:Perl,openEuler:Python,openEuler:Qt,openEuler:Ruby共19个分层工程

社区基于master分支工程做的分层project，如无特殊需求，由CICD sig组主导软件包的分层，开发者如往常提交PR至openEuler: Mainline/openEuler:Epol即可

详细分层工程介绍可参考：openEuler&OBS-Build-optimization-design2.0.md

• 分层工程建间报的移动请参阅本文第七章/1.1master下包的移动

四、提交需求，申请新增软件包纳入release发布版本ISO中正式对外发布

申请该包被纳入各个版本正式release发布的ISO交付件构建列表中，需要在版本分支拉出来之前的需求收集阶段，提需求给release sig，根据openEuler社区质量要求、版本需求接纳原则来评审；

ISO文件根据包规模大小有两类：基础ISO（大约2300+ 二进制RPM包规模），全量ISO（everything ISO,大约10000+ 二进制RPM包）。

• PR示例：https://gitee.com/openeuler/release-management/issues/I1O7RM?from=project-issue

五、release版本ISO中参与版本编译、构建申请（OBS/jenkins工程）

需求纳入release版本后，提交PR申请该包纳入release 分支对应的OBS和jenkins编译构建交付件列表

【openEuler分支中软件包增删改PR申请样例】

• 请参阅本文第七章

【jenkins构建工程PR申请样例】

• PR样例： https://gitee.com/src-openeuler/mkeuleros/pulls/91

六、Relese-management目录及pckg-mgmt字段解释

纳管master分支

• Note：社区基于master分支工程做的分层project，如无特殊需求，由CICD sig组主导软件包的分层，开发者如往常提交PR至openEuler: Mainline/openEuler:Epol即可。若开发者对于具体软件包的分层有新建议，欢迎提交issue或者邮件交流

纳管multi_version分支

纳管版本或开发分支

pckg-mgmt.yaml字段解释

七、开发者提交变更软件包流程

本章节用于指导开发者如何变更release_management下纳管分支(已停维分支除外)对应project内/不同 project之间的软件包

1.1 master下包的移动

操作实例：

修改对应目录下的pckg-mgmt.yaml，从openEuler-Mainline移动metis至openEuler-Qt，将包内容从openEuler-Mainline删除，并添加至openEuler-Qt

• note：PR合入后自动记录本次PR信息至master/release_change.yaml

1.2 master下包的删除

操作实例：

修改master/delete目录下的pckg-mgmt.yaml，将要删除的包加入到yaml中，无需从原yaml中删除该包信息

• note：PR合入后自动从原yaml中删除该包，并推送记录本次PR信息至master/release_change.yaml

1.3 master下包的新增

• note：master下包的新增均有后台任务完成，开发者不能操作

1.4 开发或者版本分支下包新增（pckg-mgmt.yaml已拆分）

操作实例：

新增python-watchdog至openEuler-2209/epol中，修改openEuler-2209/epol/pckg-mgmt.yaml，如下图

• note：PR合入后自动记录本次PR信息至openEuler-2209/release_change.yaml

1.5 开发或者版本分支内包的移动（pckg-mgmt.yaml已拆分）

操作实例：

移动openEuler-2209/epol下的包openapi-schema-validator至openEuler-2209/baseos，如下图修改对应yaml

note：同分支内包移动， 需从原yaml中删除该包信息，再到目标yaml中添加该包信息，source_dir与destination_dir都为当前分支名，obs_from为该包当前工程名

，obs_to为目标工程名

• note：PR合入后自动记录本次PR信息至openEuler-2209/release_change.yaml中

1.6 开发或者版本分支内包的删除（pckg-mgmt.yaml已拆分）

操作实例：

删除openEuler-2209/everything-exclude-baseos下的python-pythonwebhdfs，将包名写入openEuler-2209/delete/pckg-mgmt.yaml,无需从原yaml中删除该包信息，如下图

• note：PR合入后自动从原yaml中删除该包信息，并推送本次PR信息至openEuler-2209/release_change.yaml

1.7 一个PR同时提交包移动到两个分支

如果开发者希望在同一个PR中完成：

  (1) 将eagle从openEuler:Factory移动至工程openEuler:Lua;
  (2) 将eagle从openEuler:Lua引入至openEuler-22.09;

• Note：
• 1. 要在同一个PR完成不同分支的包引入或移动，分支需满足以下继承规则:https://gitee.com/openeuler/release-management/blob/master/valid_release_branches.yaml
• 2. 停维分支不支持

修改对应pckg-mgmt.yaml，如下图

• Note：PR合入后对于所有包的移动都会自动记录到对应的release_change.yaml

八、参考文档及相关社区工具操作指南链接

• OBS操作指导
• OBS master分层工程设计文档
• openeuler贡献攻略