本文分享自中移OneOS微信公众号：《CI/CD搭建流程-Gitee篇》，作者： Kisann。
Gitee CI/CD能力
Gitee，即码云，是OSCHINA.NET推出的代码托管平台，已有超过600 万的开发者选择Gitee。Gitee Go是Gitee推出的CI/CD(持续构建与集成)服务，类似GitLab CI/CD，用户可以通过自定义构建流程，实现构建集成自动化。Gitee Go目前已支持Maven、Gradle、npm、Python、Ant、PHP、Golang 等工具和语言的持续构建与集成能力。Gitee Go也支持脚本模式，即流水线文件中描述执行脚本，定义任何想做的事情，比如代码格式审查等。由于目前只支持添加Linux主机，因此脚本语言选择shell。
![]()
让Gitee Go做什么
嵌入式软件开发领域高频使用的开发语言是C语言，在大型项目中，我们往往会有格式审查、编译审查、冒烟测试等需求。如果能在代码托管平台进行格式规范审查和编译问题审查，将会大幅提高合入代码的规范性，把控新代码对原有代码的影响，提高代码整体质量。
本文将手把手教学如何让Gitee Go帮我们做代码格式审查、程序编译和冒烟测试。
快速搭建Gitee Go
集成方案
![]()
• VS Code用于本地格式化代码
– VS Code设置为文件保存时格式化
– 需要在根目录放置.clang-format文件，这是代码格式化的配置文件
• Gitee托管代码，提供push、pull request、WebHooks机制
– push、pull request可以触发流水线进行代码的格式与编译检查
– WebHooks可以触发Jenkins进行冒烟测试（需要服务器连接上测试用的硬件设备）
• Gitee Go触发流水线，在服务器进行代码格式审查与编译审查
• Gitee WebHooks用于触发Jenkins进行冒烟用例的测试。
• 服务器为作业机器，是运行格式检查、编译检查和冒烟测试的主机。
详细搭建步骤
在这里以Gitee Go做代码格式审查为例详细描述Gitee Go搭建流程：
1. 开通企业账户
注：支持免费开通并试用30天。
2. 开通Gitee Go服务：企业管理 > 代码仓库 > 某一仓库 > DevOps > Gitee Go > 同意并开通（每个代码仓库需要单独开通）
![]()
3. 领取免费500分钟构建时长：领取成功后可在 企业管理 > 基本管理设置 > 扩展应用 > Gitee Go 中看到免费赠送的时长，以及已开通Gitee Go服务的代码仓库。
![]()
4. 添加主机（流水线作业的服务器）：企业管理 > 基本管理设置 > 计算资源管理 > 新建主机组
新建主机组：
主机组的ID后续在流水线文件中要用到
![]()
主机管理 > 新建主机：
复制命令，然后你需要找到一个Linux服务器或Linux虚拟机。在Linux执行这里复制的命令，会在Linux主机开启一个代理。
![]()
执行成功后可以在页面看到一台在线的主机。
![]()
主机组与仓库关联：
关联之后，仓库就能在流水线中顺利地调用到该主机资源
![]()
到此就已完成主机的添加。
5. 流水线配置文件
代码仓库 > DevOps > Gitee Go > 新建流水线
![]()
点击代码视图，进行流水线配置文件的编写：
![]()
Gitee Go 流水线配置文件通过 YAML 语言来描述的，保存后就会看到代码仓库的根目录下多了一个.workflow文件夹，在该文件夹下有一个名为gitee-ci-pipeline.yml的流水线配置文件。
附上用于代码拉取并进行格式审查的流水线文件：
version: '1.0'
name: shell-code-style-check
displayName: 代码格式审查
stages:
- stage: ''
name: shell-code-style-heck
displayName: 代码格式审查
steps:
- step: shell@agent
name: shell-code-style-check
displayName: 代码格式审查
hostGroupID: backend-server
script: |
echo '====Get git code===='
pwd
ls
if [ ! -d "code" ];then
echo "folder not exist, new it"
mkdir code
else
echo "folder exist"
fi
cd code
ls
if [ ! -d "OneOS-Lite" ];then
echo "folder not exist, start clone"
git clone https://gitee.com/jixiaowei_cmiot/OneOS-Lite.git
cd OneOS-Lite
git checkout -b dev
git pull origin dev
else
echo "folder exist, start pull"
cd OneOS-Lite
git pull origin dev
fi
echo "====Start code style check===="
python .workflow/ci/format_check/run-clang-format.py --clang-format-executable /usr/bin/clang-format-12 -r components/
triggers:
push:
branches:
include:
- ^feature.*
- dev
6. 触发流水线
从流水线文件的triggers看出，流水线的触发方式是dev分支代码push事件，流水线会在添加的主机上进行代码拉取或更新，再调用python工具进行代码格式的审查。
触发的前的工作：先在代码根目录放置.clang-format文件，该文件是代码格式化和代码格式检查的配置文件，可以从Clang-Format官方网页下载到模板再根据自己的需求调整：
![]()
再进行VS Code保存时自动格式化的设置，这样代码保存就完成了格式化：
![]()
其次，Linux主机上安装Python和clang-format。
还有，需要将python脚本放置到代码仓库的指定路径，这样流水线配置文件中描述的shell命令才能正确执行，在Linux主机运行的话clang-format.exe是不需要的：
![]()
最后，只需要push代码或合入pull request就能触发流水线。
7. 查看流水线结果
代码仓库 > DevOps > Gitee Go >，可以看到流水线和构建历史。
![]()
在构建历史中可以查看代码需要调整格式的地方。
![]()
OneOS是中国移动针对物联网领域推出的轻量级操作系统，具有可裁剪、跨平台、低功耗、高安全等特点，支持ARM Cortex-M/R/A、MIPS、RISC-V等主流CPU架构，兼容POSIX、CMSIS等标准接口，支持Micropython语言开发，提供图形化开发工具，能够有效提高开发效率并降低开发成本，帮助客户开发稳定可靠、安全易用的物联网应用。 官网地址：https://os.iot.10086.cn/
OneOS软件地址：http://www.oschina.net/p/cmcc-oneos
OneOS项目地址：https://gitee.com/cmcc-oneos/OneOS
OneOS技术交流群：158631242
