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 我的实战建议

说了这么多,最后给你几条实在的建议:

  1. 新项目首选GitHub Actions:零配置、免维护,省心省力。
  2. 企业项目用GitLab CI:代码不出内网,安全可控。
  3. Jenkins留着对付老项目:别轻易迁移,除非你有一整个运维团队。
  4. CI配置要版本化管理:把.github/workflows/或.gitlab-ci.yml纳入版本控制,跟代码一起走。
  5. 测试要快:CI跑太久没人愿意等。我一般控制在10分钟以内,超过20分钟就得优化了。

最后提醒一句:CI不是配完就完事了。你得时不时看看构建日志,调整配置。我见过太多人配完CI就再也不管,结果某天发现测试已经挂了三个月……

好了,这一章就聊到这儿。下一章咱们聊聊「代码审查与质量门禁」,到时候我会讲讲怎么用CI自动拦截那些「看起来能编译但实际有坑」的代码。