Docker+Jenkins构建C++项目失败，求解决及CMake集成方案

解决当前构建失败问题 #

当前构建失败的核心原因是流水线脚本依赖了premake5工具，但Jenkins环境未安装该工具，且你的项目并未使用Make构建体系。直接放弃原有premake/Make相关逻辑，切换为CMake构建即可解决该问题。

Jenkins集成CMake构建C++项目方案 #

1. 确保Jenkins环境包含CMake依赖 #

修改你的Jenkins Dockerfile，添加编译工具与CMake的安装命令，保证构建环境具备必要工具：

FROM jenkins/jenkins:lts-jdk17

USER root
# 安装C++编译链、CMake、构建工具
RUN apt-get update && apt-get install -y --no-install-recommends \
    gcc \
    g++ \
    cmake \
    make \
    && rm -rf /var/lib/apt/lists/*

USER jenkins

重新构建Jenkins镜像并启动，确保环境依赖就绪。

2. 编写CMake构建流水线脚本（Jenkinsfile） #

替换Blue Ocean生成的原有流水线脚本，改用CMake的标准构建流程：

pipeline {
    agent any

    stages {
        stage('拉取代码') {
            steps {
                git url: '你的GitHub仓库地址', credentialsId: '你的GitHub Token凭证ID'
            }
        }

        stage('CMake配置') {
            steps {
                // 创建独立构建目录，避免污染源码
                sh 'mkdir -p build && cd build && cmake .. -DCMAKE_BUILD_TYPE=Release'
            }
        }

        stage('编译项目') {
            steps {
                // 多核加速编译
                sh 'cd build && make -j$(nproc)'
            }
        }

        // 可选：添加测试阶段（如果项目使用CTest）
        stage('运行测试') {
            steps {
                sh 'cd build && ctest --output-on-failure'
            }
        }
    }

    post {
        success {
            echo '构建完成'
        }
        failure {
            echo '构建失败，请检查日志'
        }
    }
}

3. 解决GitHub API限流问题 #

之前的限流是因为未认证的API请求速率限制过低（60次/小时），解决方法：

• 在Jenkins凭证管理中添加你的GitHub Token，确保流水线拉取代码时使用该凭证认证
• 认证后GitHub API速率限制提升至5000次/小时，可避免限流等待

4. 可选：使用隔离容器构建（推荐） #

如果不想在Jenkins主容器中安装依赖，可采用Docker-in-Docker模式，让构建在独立的C++编译容器中进行，示例Jenkinsfile：

pipeline {
    agent {
        docker {
            // 使用预装C++工具链的镜像，也可自定义镜像
            image 'mcr.microsoft.com/vscode/devcontainers/cpp:0-ubuntu-22.04'
            args '-v /var/run/docker.sock:/var/run/docker.sock'
        }
    }

    stages {
        stage('拉取代码') {
            steps {
                git url: '你的GitHub仓库地址', credentialsId: '你的GitHub Token凭证ID'
            }
        }

        stage('构建项目') {
            steps {
                sh 'mkdir -p build && cd build && cmake .. -DCMAKE_BUILD_TYPE=Release && make -j$(nproc)'
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者IceCode