From 1c12b3088744e4d9452544072f47c1c077ec0af3 Mon Sep 17 00:00:00 2001 From: lipingEmmaSiguyi <1477412247@qq.com> Date: Sat, 15 Apr 2023 19:09:00 +0800 Subject: [PATCH] =?UTF-8?q?=E8=BD=AF=E4=BB=B6=E5=8C=85=E5=BC=95=E5=85=A5oe?= =?UTF-8?q?pkgs=E6=8C=87=E5=AF=BC=E6=96=87=E6=A1=A3=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...06\346\224\257\347\256\241\347\220\206.md" | 51 +++++++++++++++++++ ...72\344\273\223\346\265\201\347\250\213.md" | 44 ++++++++++++++-- 2 files changed, 90 insertions(+), 5 deletions(-) create mode 100644 "doc/software-compatibility/oepkgs\345\210\206\346\224\257\347\256\241\347\220\206.md" diff --git "a/doc/software-compatibility/oepkgs\345\210\206\346\224\257\347\256\241\347\220\206.md" "b/doc/software-compatibility/oepkgs\345\210\206\346\224\257\347\256\241\347\220\206.md" new file mode 100644 index 0000000..91d8350 --- /dev/null +++ "b/doc/software-compatibility/oepkgs\345\210\206\346\224\257\347\256\241\347\220\206.md" @@ -0,0 +1,51 @@ +> **oepkgs社区软件包引入各版本分支原则：** +- 1. 软件包引入master保护分支，通过对应sig组maintainer或者对应源码仓committer review、approve即可。 +- 2. 软件包引入到oepkgs其他保护分支，需根据valid_release_branch，通过对应sig组的maintainer或者对应源码仓committer review、approve即可。 + +> **oepkgs仓库** + +- extras + oepkgs主仓，仓库中的软件包大部分取自其他仓库，以保证用户只需要添加这一个仓库，便能获取到其他所有仓库中大部分的软件包，受限于软件包多版本现状，无法覆盖所有的软件包，一部分extras仓库中无法获取的软件包，可到其他仓库中查找 + +- compatible + 通过拉取来自其他 Linux 发行版仓库中的源码包，在 openEuler 上重新编译构建，并在 openEuler 上通过了安装测试的软件包，compatible 仓库中 c6，c7，c8，f33，f34，f35，f36，rawhide 分别表示软件源码包来源是 centos6，centos7，centos8，fedora33，fedora34，fedora35，fedora36，fedora-rawhide，不同来源可以用来区分软件包的版本号，来源是 centos8 的软件包一般而言能拿到较高版本的软件包 + +- contrib + 来自许多开发者贡献的软件包，contrib 仓库下以软件包类别划分出仓库名，显然，bigdata 仓库中是大数据场景下需要应用的软件包。 + + +> **valid_release_branch:** + +- extras 仓库管控 + +| 分支名 | 解释 | +|---|---| +| master | 用于管控 oepkgs 主仓 openEuler-20.03-LTS-SP1/extras 下软件包的引入 | +| openEuler-20.03-LTS-SP1 | 用于管控 oepkgs 主仓 openEuler-20.03-LTS-SP1/extras 下软件包的引入 | +| openEuler-20.03-LTS-SP3 | 用于管控 oepkgs 主仓 openEuler-20.03-LTS-SP3/extras 下软件包的引入 | +| openEuler-22.03-LTS | 用于管控 oepkgs 主仓 openEuler-22.03-LTS/extras 下软件包的引入 | + +- compatible 仓库管控： + +| 分支名 | 解释 | +|---|---| +| compatible_c7_openEuler-20.03-LTS-SP3 | 用于管控 oepkgs compatible 仓 openEuler-20.03-LTS-SP3/compatible/c7 下软件包的引入 | +| compatible_c8_openEuler-20.03-LTS-SP3 | 用于管控 oepkgs compatible 仓 openEuler-20.03-LTS-SP3/compatible/c8 下软件包的引入 | +| compatible_f35_openEuler-20.03-LTS-SP3 | 用于管控 oepkgs compatible 仓 openEuler-20.03-LTS-SP3/compatible/f35 下软件包的引入 | + +- contrib 仓库管控： + +| 分支名 | 解释 | +|---|---| +| contrib_bigdata_openEuler-20.03-LTS-SP3 | 用于管控 oepkgs contrib 仓 openEuler-20.03-LTS-SP3/contrib/bigdata 下软件包的引入 | +| contrib_bigdata_openEuler-20.03-LTS-SP1 | 用于管控 oepkgs contrib 仓 openEuler-20.03-LTS-SP1/contrib/bigdata 下软件包的引入 | +| contrib_virtual_openEuler-20.03-LTS-SP3 | 用于管控 oepkgs contrib 仓 openEuler-20.03-LTS-SP3/contrib/virtual 下软件包的引入 | +| contrib_basic-system_openEuler-20.03-LTS-SP3 | 用于管控 oepkgs contrib 仓 openEuler-20.03-LTS-SP3/contrib/basic-system 下软件包的引入 | + +- contrib multi_version 仓库管控（openstack 有 Queens、Rocky、Wallaby 等多版本的软件包引入） + +| 分支名 | 解释 | +|---|---| +| Muti-Version_openstack-wallaby_openEuler-20.03-LTS-SP3 | 用于管控 oepkgs contrib 仓 openEuler-20.03-LTS-SP3/contrib/openstack/wallaby 下软件包的引入 | +| Muti-Version_openstack-rocky_openEuler-20.03-LTS-SP3 | 用于管控 oepkgs contrib 仓 openEuler-20.03-LTS-SP3/contrib/openstack/rocky 下软件包的引入 | +| Muti-Version_openstack-queens_openEuler-20.03-LTS-SP3 | 用于管控 oepkgs contrib 仓 openEuler-20.03-LTS-SP3/contrib/openstack/queens 下软件包的引入 | \ No newline at end of file diff --git "a/doc/software-compatibility/rpm\346\236\204\345\273\272\344\273\245\345\217\212\345\273\272\344\273\223\346\265\201\347\250\213.md" "b/doc/software-compatibility/rpm\346\236\204\345\273\272\344\273\245\345\217\212\345\273\272\344\273\223\346\265\201\347\250\213.md" index d72fd2d..3aec648 100644 --- "a/doc/software-compatibility/rpm\346\236\204\345\273\272\344\273\245\345\217\212\345\273\272\344\273\223\346\265\201\347\250\213.md" +++ "b/doc/software-compatibility/rpm\346\236\204\345\273\272\344\273\245\345\217\212\345\273\272\344\273\223\346\265\201\347\250\213.md" @@ -8,6 +8,10 @@ #### 一、基于PR，创建仓库 在[oepkgs-management](https://gitee.com/oepkgs/oepkgs-management)仓库提PR(如何提PR，详见文档最后的[QA](##QA))，填写两个配置文件，PR合入之后，创仓机器人ci-robot会在[src-oepkgs](https://gitee.com/src-oepkgs)下面自动创建仓库。 +> **说明:** +> - oepkgs仓库将软件包按照领域、类别划分，不同领域及类别的软件包由**不同的sig组**进行维护 + + oepkgs-management仓库中的两个配置文件(以nginx为例)： ``` # 在oepkgs-management仓库sig目录下面创建虚拟化领域的sig组 @@ -29,19 +33,38 @@ maintainers: # 该sig组管理的仓库 repositories: - repo: - - src-oepkgs/nginx + - src-oepkgs/nginx + committers: + - gitee_id: lipingEmmaSiguyi + name: Ping Li + email: liping136@huawei.com ``` +> **说明:** +> - 开源软件引入**oepkgs已有sig组**，提交申请创仓PR，可基于对应sig组的sig-info.yaml文件进行修改，不强制要求开源软件引入oepkgs仓，需要新建sig组 + + +sig-info.yaml 字段解释: + +| 字段 | 解释 | 是否必填 | +|---|---|---| +| name | sig组名称，一般跟软件包领域相关 | √ | +| description | 对该sig的描述 | √ | +| mailing_list | sig组的订阅邮箱地址 | × | +| meeting_url | sig组会议链接 | × | +| maintainers | sig组的管理者，负责该sig组下源码仓pr的检视与合入 | √ | +| repositories | sig组下面的源码仓 | √ | +| committers | sig组下面某些源码仓的committers，负责对应仓库PR的检视与合入 | √ | ``` # 在oepkgs-management/sig/virtual下面创建src-oepkgs/仓库名称首字母/仓库名称.yaml -# ci-rebot将依据这个文件进行自动建仓 -oepkgs-management/sig/virtual/src-oepkgs/q/nginx.yaml: +# ci-robot将依据这个文件进行自动建仓 +oepkgs-management/sig/virtual/src-oepkgs/n/nginx.yaml: # 仓库名称 name: nginx description: "nginx is a generic and open source processor emulator which achieves a good emulation speed by using dynamic translation" -# 仓库地址 -upstream: https://gitee.com/src-oepkgs/nginx +# 上游仓库地址 +upstream: https://github.com/nginx/nginx.git # 仓库分支 branches: - name: master @@ -54,6 +77,17 @@ branches: create_from: master type: public ``` + +仓库配置文件字段解释： + +| 字段 | 解释 | 是否必填 | +|---|---|---| +| name | 包名（源码仓名） | √ | +| description | 对软件包的描述 | √ | +| upstream | 软件包上游仓库地址 | √ | +| branches | 仓库分支，oepkgs镜像源分支管理详见：[oepkgs分支管理文档](./oepkgs分支管理.md) | √ | + + #### 二、补充源码文件 完成步骤一之后，5分钟内会生成 https://gitee.com/src-oepkgs/nginx 仓库，通过PR往这个仓库中补充源码文件： -- Gitee