13、持续集成(CI):GitHub Actions、GitLab CI、Jenkins配置C++项目
持续集成,说白了就是让机器替你跑那些重复的活儿。你想想看,每次提交代码后,手动编译、跑测试、检查代码风格……这些事做一次两次还行,天天做谁受得了?我早年带团队时,有个哥们儿连续三天忘了跑静态检查,结果合进去一堆野指针。从那以后,我就把CI当成了项目的「守门员」。
今天咱们聊聊三种主流CI工具:GitHub Actions、GitLab CI、Jenkins。它们都能搞定C++项目,但各有各的脾气。
13.1 为什么C++项目需要CI?
C++这语言,编译慢、依赖多、跨平台坑也多。没有CI,你根本不知道代码在别人机器上能不能跑起来。
CI的核心价值:
- 编译验证:确保每次提交都能通过编译
- 单元测试:自动运行gtest、catch2等测试框架
- 静态分析:用clang-tidy、cppcheck检查代码质量
- 跨平台构建:同时验证Linux、macOS、Windows
我个人习惯,CI配置里至少包含这三步:编译、测试、代码检查。缺一步都不踏实。
13.2 GitHub Actions:最省心的选择
如果你的代码托管在GitHub上,那GitHub Actions就是首选。它跟仓库深度绑定,配置起来特别顺手。
我曾经帮一个开源项目配CI,从零到跑通只花了20分钟。为什么这么快?因为GitHub Actions有现成的C++ action,你直接拿来用就行。
13.2.1 基础配置示例
在项目根目录创建 .github/workflows/ci.yml:
name: C++ CI
on:
push:
branches: [ main, develop ]
pull_request:
branches: [ main ]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: 安装依赖
run: |
sudo apt-get update
sudo apt-get install -y cmake g++ libgtest-dev
- name: 配置CMake
run: cmake -B build -DCMAKE_BUILD_TYPE=Release
- name: 编译
run: cmake --build build --parallel
- name: 运行测试
run: cd build && ctest --output-on-failure
嗯,这里要注意:--parallel参数能充分利用多核CPU,编译速度能快好几倍。我见过有人忘了加这个,每次等编译等得抓狂。
13.2.2 矩阵构建:一次搞定多个平台
C++项目最头疼的就是跨平台兼容。GitHub Actions的矩阵构建能帮你一次跑多个环境:
jobs:
build:
strategy:
matrix:
os: [ubuntu-latest, macos-latest, windows-latest]
compiler: [gcc, clang]
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v3
- name: 设置编译器
run: |
if [ "${{ matrix.compiler }}" = "gcc" ]; then
echo "CC=gcc" >> $GITHUB_ENV
echo "CXX=g++" >> $GITHUB_ENV
else
echo "CC=clang" >> $GITHUB_ENV
echo "CXX=clang++" >> $GITHUB_ENV
fi
- name: 构建
run: |
cmake -B build
cmake --build build
小技巧:矩阵构建会并行跑多个job,免费额度够用。但别配太多,小心把GitHub的免费额度跑光了。我一般控制在4-6个组合。
13.3 GitLab CI:自托管的首选
GitLab CI跟GitLab Runner配合,可以跑在自己的服务器上。对于需要保密代码的企业项目,这招特别好使。
我记得有个金融客户,代码绝对不能出内网。我们就用GitLab CI搭了一套内部CI系统,跑得比GitHub Actions还快——因为服务器就在隔壁机房。
13.3.1 配置示例
在项目根目录创建 .gitlab-ci.yml:
stages:
- build
- test
- analyze
build-job:
stage: build
image: gcc:12
script:
- cmake -B build -DCMAKE_BUILD_TYPE=Release
- cmake --build build --parallel
artifacts:
paths:
- build/
test-job:
stage: test
image: gcc:12
script:
- cd build && ctest --output-on-failure
dependencies:
- build-job
analyze-job:
stage: analyze
image: gcc:12
script:
- apt-get update && apt-get install -y clang-tidy
- clang-tidy src/*.cpp -- -Iinclude
dependencies:
- build-job
避坑指南:我曾经在GitLab CI里忘了设置dependencies,结果测试job拿不到编译产物,直接报错。记住:job之间传递文件,必须显式声明依赖关系。
13.3.2 缓存加速
C++编译慢,缓存是关键。GitLab CI支持缓存第三方库和编译中间文件:
cache:
paths:
- build/_deps/
- build/CMakeFiles/
build-job:
stage: build
cache:
key: $CI_COMMIT_REF_SLUG
paths:
- build/
script:
- cmake -B build
- cmake --build build
你想想看,第一次编译可能要10分钟,有了缓存后第二次只要2分钟。这效率提升,谁用谁知道。
13.4 Jenkins:老牌劲旅,灵活但重
Jenkins我用了快十年了。它最大的优点是灵活——什么插件都有,什么平台都能跑。但缺点也很明显:配置复杂,维护成本高。
说实话,现在新项目我很少用Jenkins了。除非是那种有历史包袱的老项目,或者需要高度定制化流水线的场景。
13.4.1 Jenkinsfile示例
Jenkins的流水线定义在 Jenkinsfile 中:
pipeline {
agent any
stages {
stage('Checkout') {
steps {
checkout scm
}
}
stage('Build') {
steps {
sh '''
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel
'''
}
}
stage('Test') {
steps {
sh 'cd build && ctest --output-on-failure'
}
post {
always {
junit 'build/test-results/*.xml'
}
}
}
stage('Static Analysis') {
steps {
sh 'clang-tidy src/*.cpp -- -Iinclude'
}
}
}
post {
failure {
emailext(
subject: "构建失败: ${env.JOB_NAME} - ${env.BUILD_NUMBER}",
body: "请检查构建日志: ${env.BUILD_URL}",
to: "team@example.com"
)
}
}
}
Jenkins的优势场景:
- 需要集成SonarQube做代码质量门禁
- 需要对接企业内部的LDAP、权限系统
- 需要复杂的并行流水线(比如同时编译多个架构)
13.5 三种工具的对比
| 特性 | GitHub Actions | GitLab CI | Jenkins |
|---|---|---|---|
| 上手难度 | 低 | 中 | 高 |
| 托管方式 | 云托管 | 云/自托管 | 自托管 |
| 免费额度 | 2000分钟/月 | 400分钟/月 | 无限制(自建) |
| C++生态支持 | 好(有现成action) | 中(需自己配) | 好(插件丰富) |
| 适合场景 | 开源项目、小团队 | 企业内网项目 | 大型复杂流水线 |
13.6 我的实战建议
说了这么多,最后给你几条实在的建议:
- 新项目首选GitHub Actions:零配置、免维护,省心省力。
- 企业项目用GitLab CI:代码不出内网,安全可控。
- Jenkins留着对付老项目:别轻易迁移,除非你有一整个运维团队。
- CI配置要版本化管理:把
.github/workflows/或.gitlab-ci.yml纳入版本控制,跟代码一起走。 - 测试要快:CI跑太久没人愿意等。我一般控制在10分钟以内,超过20分钟就得优化了。
最后提醒一句:CI不是配完就完事了。你得时不时看看构建日志,调整配置。我见过太多人配完CI就再也不管,结果某天发现测试已经挂了三个月……
好了,这一章就聊到这儿。下一章咱们聊聊「代码审查与质量门禁」,到时候我会讲讲怎么用CI自动拦截那些「看起来能编译但实际有坑」的代码。