OpenCloudOS 社区适配流程手册

OpenCloudOS 作为产品底座支撑海量业务运行，具备完整的适配生态认证体系。欢迎软硬件厂商加入 OpenCloudOS 社区和完成产品适配，帮助产品稳定、正常运行在 OpenCloudOS 操作系统之上，同时可在适配的基础上探索更多交流与合作。

合作接口人：陈晴敏（qingmin0623）
适配与 kernel SIG、Testing SIG、Stream SIG 等小组共同协作

适配流程图

适配申请、专项沟通

1. 提交适配需求
   联系适配接口人提交适配需求，包括企业名称、产品名称、官网、适配背景等内容
   硬件适配还可涉及驱动支持/特性优化/补丁合入等内容

2. 建立专项交流群
   评估需求后，由社区工作人员主动与适配厂商建立微信沟通群，在群里对后续流程进行专项交流

适配流程介绍

安装操作系统

选择操作系统，OpenCloudOS 版本具体介绍说明

1. OpenCloudOS 8【kernel 5.4、用户态软件兼容 CentOS 8】
2. 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
• OS_smoke 冒烟测试工具（一套专为操作系统设计的轻量级、自动化冒烟测试工具。主要用于在系统镜像构建完成后，第一时间对系统进行全方位的“健康检查”，快速验证内核、基础系统、驱动、开发工具等关键组件是否正常工作）：https://gitee.com/OpenCloudOS/os_smoke
• 建议在官网/文档库同步添加基于 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
• 左下角：公司名称 + 认证时间

适配者完成证书补充后，请回传至沟通群内进行审核

证书、测试报告归档

内容确认无误后，厂商先发起盖章，盖章后回传高清扫描件

OpenCloudOS官方网址：https://docs.opencloudos.org/