GitLab Runner 与 Jenkins 定位不同,通常不混用:前者是 GitLab CI 的专用执行器,后者是独立 CI/CD 服务器;推荐路径一是 GitLab CI + Runner(轻量、原生容器支持),路径二是 Jenkins 主导拉代码+本地 Docker 构建;避免在 Jenkins 中调用 Runner 或 Runner 触发 Jenkins,以防故障与权限混乱。

直接用 Jenkins 配合 GitLab Runner 做容器化多阶段流水线,其实不是“结合使用”的关系——而是二者定位不同、通常不混用。GitLab Runner 是 GitLab CI 的执行器,专为 .gitlab-ci.yml 服务;Jenkins 是独立的 CI/CD 服务器,靠自身 Agent 或插件拉代码、跑任务。想“利用 Jenkins 结合 GitLab Runner”,常见误解,实际有两条清晰路径:
路径一:用 GitLab CI + GitLab Runner(推荐,更轻量、原生容器支持)
这是 GitLab 生态最自然的选择,无需 Jenkins 参与,天然支持 Docker 容器化和多阶段。
-
前提:GitLab 实例已部署,且已注册至少一个 GitLab Runner(支持
dockerexecutor) -
关键配置:在项目根目录放
.gitlab-ci.yml,明确声明 stages 和每个 job 使用的镜像 -
示例结构:
image: docker:latest services: - docker:dind variables: DOCKER_TLS_CERTDIR: "/certs" stages: - build - test - deploy <p>build-app: stage: build script:</p><ul><li>docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA .</li><li>docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA</li></ul><p>run-tests: stage: test image: node:18-alpine script:</p><ul><li>npm ci</li><li>npm test</li></ul><p>deploy-staging: stage: deploy image: alpine:latest script:</p><ul><li>apk add curl</li><li>curl -X POST "<a href="https://www.php.cn/link/b56669fbdab303dea8afe5483fe4c3ad">https://www.php.cn/link/b56669fbdab303dea8afe5483fe4c3ad</a>" --user "$JENKINS_USER:$JENKINS_TOKEN" only:</li><li>main
- 优势:每个 job 自动运行在干净容器中;Docker in Docker(dind)支持镜像构建;阶段并行、条件触发、手动审批节点开箱即用
路径二:用 Jenkins 主导,从 GitLab 拉代码 + 调用本地 Docker 构建
适合已有 Jenkins 投入、需复用插件生态(如 Blue Ocean、Pipeline Utility Steps)或跨 SCM 场景。
当用户提及 GitHub URL,或要求分析、审查、探索或理解任意 GitHub 项目、仓库或代码库时,请使用此技能。触发条件包括以下短语:“分析这个项目”、“看看这个仓库”、“analyze this repo”、“what does this project do”,或消息中包含任何 github.com URL。
-
核心准备:
- Jenkins 服务器安装 Docker CLI,并确保 jenkins 用户可执行
docker(sudo usermod -aG docker jenkins) - 在 Jenkins 中添加 GitLab 凭据(SSH Key 或 Personal Access Token)
- 安装必要插件:GitLab Plugin、Pipeline Utility Steps、Docker Pipeline
- Jenkins 服务器安装 Docker CLI,并确保 jenkins 用户可执行
-
Jenkinsfile 示例(声明式):
pipeline { agent { label 'docker-host' } // 确保该节点装了 Docker environment { IMAGE_NAME = 'myapp' REGISTRY = 'registry.example.com' } stages { stage('Checkout') { steps { checkout scmGit(branches: [[name: '*/main']], extensions: [], userRemoteConfigs: [[url: 'https://gitlab.example.com/group/project.git', credentialsId: 'gitlab-token']]) } } stage('Build & Push') { steps { script { docker.build("$REGISTRY/$IMAGE_NAME:$BUILD_NUMBER").push() } } } stage('Deploy to Staging') { steps { sh 'kubectl set image deployment/myapp myapp=$REGISTRY/$IMAGE_NAME:$BUILD_NUMBER -n staging' } } } } - 注意点:不要在 Jenkins 里再起 GitLab Runner;若想触发 GitLab 后续动作(如 MR 状态更新),可用 GitLab API 或 Webhook 回调
不建议的“混合”做法
比如在 Jenkins 流水线里启动 gitlab-runner exec docker,或让 GitLab Runner 去调 Jenkins API 触发构建——这会增加单点故障、权限混乱和调试复杂度。GitLab Runner 不是通用任务调度器,它的设计目标是高效执行 .gitlab-ci.yml 定义的 job。
选哪条路,取决于你当前技术栈重心:GitLab 已是主力代码平台,就用原生 CI;Jenkins 已深度定制且团队熟悉,就让它管全流程。两者都能实现容器化、多阶段、自动部署,但别强行“结合”。

















