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>
- docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA .
- docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
run-tests: stage: test image: node:18-alpine script:
- npm ci
- npm test
deploy-staging: stage: deploy image: alpine:latest script:
- apk add curl
- curl -X POST "https://www.php.cn/link/b56669fbdab303dea8afe5483fe4c3ad" --user "$JENKINS_USER:$JENKINS_TOKEN" only:
- main
- 优势:每个 job 自动运行在干净容器中;Docker in Docker(dind)支持镜像构建;阶段并行、条件触发、手动审批节点开箱即用
路径二:用 Jenkins 主导,从 GitLab 拉代码 + 调用本地 Docker 构建
适合已有 Jenkins 投入、需复用插件生态(如 Blue Ocean、Pipeline Utility Steps)或跨 SCM 场景。
生成周报:读取本机 Git 仓库最近一周的提交记录,按项目分类提炼总结,生成标准周报格式,通过微信推送并返回给用户。触发词:周报、weekly report、git总结、提交记录总结、工作周报。
-
核心准备:
- 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 已深度定制且团队熟悉,就让它管全流程。两者都能实现容器化、多阶段、自动部署,但别强行“结合”。










