OpenCloudOS 社区适配流程手册
OpenCloudOS 作为产品底座支撑海量业务运行,具备完整的适配生态认证体系。欢迎软硬件厂商加入 OpenCloudOS 社区和完成产品适配,帮助产品稳定、正常运行在 OpenCloudOS 操作系统之上,同时可在适配的基础上探索更多交流与合作。
合作接口人:陈晴敏(qingmin0623)
适配与 kernel SIG、Testing SIG、Stream SIG 等小组共同协作
适配流程图
适配申请、专项沟通
-
提交适配需求
联系适配接口人提交适配需求,包括企业名称、产品名称、官网、适配背景等内容
硬件适配还可涉及驱动支持/特性优化/补丁合入等内容 -
建立专项交流群
评估需求后,由社区工作人员主动与适配厂商建立微信沟通群,在群里对后续流程进行专项交流
适配流程介绍
安装操作系统
选择操作系统,OpenCloudOS 版本具体介绍说明
- OpenCloudOS 8【kernel 5.4、用户态软件兼容 CentOS 8】
- OpenCloudOS 9【kernel 6.6、用户态软件自主编译,不依赖第三方发行版】
安装 OpenCloudOS 操作系统
- 方法一:自行下载 ISO 镜像 https://opencloudos.org/ospages/download
- 方法二:联系接口人,可提供 CVM 云服务器环境测试
适配测试
常规测试方式:自主测试
申请者按照参考《测试报告模版》内容,使用常见测试用例进行测试,例安装部署测试、功能测试、性能测试,记录不少于 10 项测试用例。需记录关键的环境依赖及其版本,确保在 OpenCloudOS 操作系统中具有可靠、稳定的环境,完成后提交适配组审核、验证。
- 测试报告模板链接:产品互认证测试模板.docx
- 软件建议测试项目:https://docs.opencloudos.org/adaptation/testcase_soft
- 硬件建议测试项目:https://docs.opencloudos.org/adaptation/testcase
- 硬件测试可使用基础兼容性测试工具(建议同步附加厂商的测试用例):https://gitee.com/opencloudos-stream/oc-hct
- 建议在官网/文档库同步添加基于 OpenCloudOS 的部署文档,OpenCloudOS 也会同步更新到产品的文档库里
硬件驱动适配
- 方法一:如果整套驱动包含了用户态的库或内核驱动模块代码量很大、源码没有内聚在驱动目录下,建议在官网分别展示支持 OpenCloudOS 版本的驱动安装包,供使用者从官网上下载已构建好的驱动。或者单独以 rpm 包的方式集成进 OS 的 yum 源里。
- 方法二:如果驱动代码量较小(小于200KB),可安装 OpenCloudOS 对应版本 ISO 进行测试,提交驱动到 OpenCloudOS kernel gitee 仓库,集成进 OpenCloudOS 操作系统
5.4 内核提交至分支:https://gitee.com/OpenCloudOS/OpenCloudOS-Kernel/tree/linux-5.4/devel
6.6 内核提交至分支:https://gitee.com/OpenCloudOS/OpenCloudOS-Kernel/tree/linux-6.6/devel
安全公告数据适配
- 获取数据:从 OpenCloudOS 社区提供的安全数据 API(https://docs.opencloudos.org/security_data_api )获取 OpenCloudOS 8 /OpenCloudOS 9 的安全漏洞修复数据,对于评估为不修复/不涉及的漏洞,会在安全数据 API 中的漏洞条目中给出相关信息;
- 适配数据:将数据集成至扫描工具的漏洞库。扫描最新发布的 OpenCloudOS ,确保扫描结果中没有误报。
用户态、软件栈、特性优化等适配
社区工作人员专项支持
认证证书
补充证书内容
在确认测试通过后,OpenCloudOS 社区会为申请者颁发《兼容认证证书》,在沟通群内提供认证证书模板,申请者请在相应位置填加:
- 正文第一段:适配软件名
- 右上角:公司 logo
- 左下角:公司名称 + 认证时间
适配者完成证书补充后,请回传至沟通群内进行审核
证书、测试报告归档
内容确认无误后,厂商先发起盖章,盖章后回传高清扫描件
官网更新
完成证书双签后,适配组将对报告、证书进行归档管理,并更新产品至官网列表: