社区网站发布通过OSV认证的厂商及版本号,对外价值 — 确保根生态一致性,核心特性继承,生态可复用;对内价值 — 反生态分裂识别,保障技术路线演进,OSV认证方案:聚焦openEuler内核和基础包,约束伙伴二次发行版生态核心特性不丢失,关键配置不更改
Compatible全量换标版本(暂不对外公布)
在Compatible 深度基础上,软件包版本、特性、配置、补丁全部保持一致,主要更换了发型版版本信息,与openEuler 仓库100%复用。
Compatible深度:主力行业场景生态复用(对外公布,通用OSV)
在Compatible 基础基础上,检测生态复用,扩展竞争力特性(etmem、热升级、isulad)继承检测;扩展标准包到L2包一致性,主流行业应用生态复用度90%。检查发行版是否结合社区选包策略及软件包等级策略,检查L1、L2软件包版本、打包方式、接口一致性,实现扩展仓库openEuler系共享、共用。
Compatible基础:特性/配置继承 (对外公布,企业OSV)
主要检测openEuler 技术路线,是否有反分裂行为,核心包L1(内核、glibc)及包管理体系一致性,KABI白名单,架构特性(如鲲鹏/X86特性)使能,性能优化配置。检查发行版是否技术路线一致,是否有反分裂行为,核心包一致性,如支持鲲鹏补丁、X86补丁、isulad、热升级等特性合入,充分发挥openEuler竞争力特性。
检查项
序号 | 检查 |
---|---|
1 | 软件包检测 |
2 | 接口检测 |
3 | 特性检测 |
4 | 配置检测 |
5 | 补丁检测(需要依赖源码) |
验证项
序号 | 验证项 | 测试 |
---|---|---|
1 | 兼容性测试 | 安装、卸载、命令、服务 |
2 | 基础性能测试 | 基础benchmark 测试 |
3 | 特性测试 | 特性功能验证 |
4 | 功能测试 | 基础AT测试 |
组件 | 组件描述 | 可获得性 |
---|---|---|
python3 | python3.7.9及以上 | 可先通过yum list命令查看,如果没有该版本需要下载安装 |
sqlite | v3.7.17 及以上版本 | 系统自带 |
abidiff | 1.6.0 | 挂载openEuler20.03-LTS-SP2的yum源之后,yum install libabigail |
japi-compliance-checker | 2.4 | https://github.com/lvc/japi-compliance-checker |
在运行oecp分析之前,确保虚拟机或物理机的运行规格大于等于2U8G,运行前建议重启虚拟机,保证空闲内存足够,建议oecp所在目录空闲磁盘至少保留20GB(具体以实际扫描rpm包数量为准)
任务分析项 | CPU资源消耗 | 运行耗时 | 输出件大小 |
---|---|---|---|
比较两个iso镜像所有比较计划 | 2核心,峰值100% | 20~60分钟 | 程序正常结束,百兆级别,具体大小和比较的镜像差异有关 |
比较两个iso镜像所有比较计划 | 16核心,峰值100% | 10~60分钟 | 程序正常结束,百兆级别,具体大小和比较的镜像差异有关 |
除了相关组件安装,oecp可完全离线运行,无需连接网络
主目录 | 二级目录 | 三级目录 | 描述 |
---|---|---|---|
cli.py | 命令启动脚本 | ||
requirement | 工具依赖清单 | ||
README.md | 用户指导手册 | ||
test | 测试脚本夹 | ||
doc | 设计文档文件夹 | ||
oecpimg | 存放文档图片 | ||
oecp-dev-1.0.md | 设计文档 | ||
oecp-module-dev-1.0.md | 模块设计文档 | ||
oecp | |||
main | 主模块 | ||
factory.py | 工厂方法,生产ISO、REPO等比较对象 | ||
directory.py | 目录级别对象、ISO对象、REPO对象 | ||
repository.py | 仓库级别对象 | ||
mapping | 二进制包和源码包映射 | ||
category.py | 软件包、二进制包等级 | ||
plan.py | 比较计划 | ||
executor | 比较模块 | ||
base.py | 比较器基类 | ||
abi.py | 比较abi | ||
jabi.py | 比较jar abi | ||
list.py | 比较文件列表、包列表 | ||
null.py | 空比较,当比较计划项只需要dumper时使用 | ||
nvs.py | 符号、版本、名称比较器 | ||
plain.py | 文件比较 | ||
dumper | dumper模块 | ||
base.py | dumper基类 | ||
abi.py | 动态库abi | ||
config.py | rpm包的配置文件 | ||
extract.py | 提取rpm包内容 | ||
filelist.py | 文件列表 | ||
jabi.py | jar包abi | ||
kabi.py | 内核abi | ||
kconfig.py | 内核配置 | ||
null.py | 当比较计划项只需要执行比较时使用 | ||
packagelist.py | ISO中包列表 | ||
provides.py | rpm包提供的符号 | ||
requires.py | rpm包依赖的符号 | ||
result | 结果模块 | ||
compare_result.py | 保存结果对象 | ||
constants.py | 比较类型、比较结果宏 | ||
export.py | 导出比较结果到csv文件 | ||
test_result.py | 导出compass-ci比较的结果 | ||
proxy | 第三方代理模块 | ||
rpm_proxy.py | rpm包常用方法 | ||
proxy/requests_proxy.py | requests功能封装下载功能 | ||
utils | 工具模块 | ||
utils/logger.py | 日志 | ||
utils/misc.py | 常用工具 | ||
utils/shell.py | shell命令 | ||
utils/unit_convert.py | 单位转换 | ||
conf | 配置模块 | ||
category | 包等级配置 | ||
performance | compass-ci性能测试 | ||
plan | 比较计划 | ||
logger.conf | 日志配置 |
oecp工具适用于比较两个ISO镜像之间的差别,具体比较项有:
1)仓库rpm的packagelist(两个仓库包名、版本号、release号比较),对应报告比较类型如下:
2)abi(库文件接口)、jabi(java接口)、config(rpm包内配置文件差异)、kabi(内核abi)、kconfig(内核配置文件),对应报告比较类型如下:
3)provides(rpm的provides)、requires(rpm的依赖)等, 对应报告比较类型如下:
4)unixbench, lmbench, mysql性能测试,对应报告比较类型如下:
5)服务命令起停测试,对应报告比较类型如下:
install abidiff (centos): ''' yum install -y epel-release yum install -y libabigail '''
install japi: ''' git clone https://github.com/lvc/japi-compliance-checker cd japi-compliance-checker sudo make install prefix=/usr '''
install oecp: ''' git clone https://gitee.com/lovelijunyi/oecp cd oecp pip3 install -r requirement '''
使用前,安装python依赖库 pip3 install -r requirement
python3 cli.py [-h] [-n PARALLEL] [-w WORK_DIR] [-p PLAN_PATH] [-c CATEGORY_PATH] [-b PERF_BASELINE_FILE] [-a {x86_64,aarch64}] [-f OUTPUT_FORMAT] [-o OUTPUT_FILE] file1 file2
位置参数(必选)
file
指定两个比较的iso文件可选参数
-n, --parallel
指定进程池并发数量
,默认cpu核数
-w, --work-dir
指定工作路径
,默认路径为/tmp/oecp
-p, --plan
指定比较计划
,默认为oecp/conf/plan/all.json
-c, --category
指定包级别信息
,默认为oecp/conf/category/category.json
-b, --baseline
指定基线文件
,默认为oecp/conf/performance/openEuler-20.03-LTS-aarch64-dvd.iso.performance.json
-f, --format
指定输出格式
,默认为csv
-o, --output
指定输出结果路径
,默认为/tmp/oecp
举例
python3 cli.py /root/openEuler-20.03-LTS-aarch64-dvd.iso /root/openEuler-20.03-LTS-SP1-aarch64-dvd.iso
比较计划说明
all.json
涵盖下面所有配置项的比较以下比较项只作为调试用,无法单独进行比较生成结果,请注意
abi.json
比较rpm包中so库文件的abi接口,需依赖RPMExtractDumper(提取解压rpm的dumper类)config_file.json
比较rpm包中配置文件内容的差异,需依赖RPMExtractDumper(提取解压rpm的dumper类)filelist.json
比较rpm包文件列表差异,可通过rpm -pql ${rpm_path}命令获取rpm文件列表jabi.json
比较rpm中jar包的java接口,需依赖RPMExtractDumper(提取解压rpm的dumper类)kabi.json
比较内核rpm包的abi接口,需依赖RPMExtractDumper(提取解压rpm的dumper类)
默认白名单为aarch64,如需要比较x86需要更换"white_list": "kabi_whitelist/x86_64"kconfig.json
比较内核配置文件,需依赖RPMExtractDumper(提取解压rpm的dumper类)package_list.json
比较两个rpm集合包名称、版本、发行版本的差异provides_requires.json
比较rpm的provides和requires差异,可通过rpm -pq --provides/requires ${rpm_path}查询此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。