从 Jenkins 迁移到 GitLab CI

适用场景

希望减少 Jenkins 插件和主从维护，统一代码、流水线和制品到 GitLab。迁移难点在 Jenkinsfile 语义、凭据、构建环境和制品传递。

前置条件

• GitLab 项目和 Runner。
• 梳理 Jenkins Job、Pipeline、凭据和构建节点。
• 确认私有依赖、缓存和制品存储。
• 保留 Jenkins 作为回滚路径。

步骤

1. 导出 Jenkins 配置：

kubectl -n jenkins get configmap -o yaml > jenkins-config.yaml
find $JENKINS_HOME/jobs -name config.xml -maxdepth 3

2. 梳理构建步骤和凭据：

grep -nE 'sh\(|withCredentials|archiveArtifacts|publish|docker' Jenkinsfile

3. 安装 GitLab Runner：

helm repo add gitlab https://charts.gitlab.io
helm install gitlab-runner gitlab/gitlab-runner \
  --namespace gitlab-runner --create-namespace \
  --set gitlabUrl=https://gitlab.example.com \
  --set runnerRegistrationToken='***'

4. 编写 .gitlab-ci.yml：

stages: [build, test, package]

variables:
  DOCKER_BUILDKIT: "1"

build:
  stage: build
  image: maven:3.9-eclipse-temurin-21
  script:
    - mvn -B clean package
  artifacts:
    paths: [target/*.jar]

test:
  stage: test
  image: maven:3.9-eclipse-temurin-21
  script:
    - mvn -B test

package:
  stage: package
  image: docker:27
  services: [docker:27-dind]
  script:
    - docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA .
    - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA

5. 迁移凭据到 GitLab CI/CD Variables，使用 masked/protected。

6. 配置缓存和制品过期时间，避免存储膨胀。

7. 并行运行 Jenkins 和 GitLab CI，对比构建结果后再切换。

验证

• 流水线在 MR 和主分支都能触发。
• 构建、测试、镜像推送成功。
• 制品能下载，版本号正确。
• 凭据没有出现在日志中。
• Runner 扩容和并发满足需求。

回滚

• 保留 Jenkins Job 和凭据。
• 保留旧流水线触发方式。
• 切换时先停止 Jenkins 自动触发，避免重复构建。
• 镜像 tag 使用不可变值，回滚不依赖重新构建。

常见坑

• Jenkins 的 withCredentials 文件凭据在 GitLab 中需要转成 File 类型变量。
• 构建节点工具链版本不同，编译结果不一致。
• 缓存 key 设计不当，依赖缓存污染。
• GitLab Runner 的 Docker-in-Docker 需要特权或正确配置。
• 制品路径和过期时间没有配置，存储快速增长。
• Jenkins 的共享库逻辑没有迁移，重复代码多。
• 只迁移主分支，MR 流水线和标签流水线遗漏。

相关命令

• gitlab-runner — Runner 注册和管理
• gitlab-ci — 流水线配置
• docker — 镜像构建
• jenkins — 旧流水线对照