在Jenkins声明式Kubernetes流水线中持久化Maven仓库

问题背景 #

我们在Kubernetes上运行Jenkins声明式流水线，希望在流水线运行之间缓存Maven构件，避免每次构建都重新下载依赖。考虑通过PV/PVC持久化.m2目录，但不确定声明式流水线是否支持，想了解这是否为最佳方案，或是有其他替代方案。

当前使用的核心配置如下：

原Jenkinsfile #

pipeline {
  agent {
    kubernetes {
      yamlFile 'ci-cd/BuildPod.yaml'
    }
  }
  ...
}

原BuildPod.yaml #

apiVersion: v1
kind: Pod
metadata:
  namespace: jenkins
  labels:
    jenkins/label: 'api-slave'
spec:
  containers:
    - name: jnlp
    - name: mavenenv
      image: maven:3.6.2
      command:
        - bash
  ...
}

一、PV/PVC持久化.m2目录（推荐最佳方案） #

在Kubernetes环境中，PV/PVC是持久化存储的标准方案，完全支持Jenkins声明式流水线，能可靠地在流水线运行之间保留Maven依赖。

实现步骤 #

1. 提前创建PVC
   在Jenkins命名空间下创建用于存储Maven构件的PVC：

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: maven-cache-pvc
     namespace: jenkins
   spec:
     accessModes:
       - ReadWriteMany # 支持多个流水线Pod同时读写，适合多任务共享缓存
     resources:
       requests:
         storage: 20Gi # 根据实际依赖大小调整
   

2. 修改BuildPod.yaml挂载PVC
   在Pod配置中添加卷和挂载规则，将PVC挂载到Maven容器的默认构件存储目录：

   apiVersion: v1
   kind: Pod
   metadata:
     namespace: jenkins
     labels:
       jenkins/label: 'api-slave'
   spec:
     volumes:
       - name: maven-repo
         persistentVolumeClaim:
           claimName: maven-cache-pvc
     containers:
       - name: jnlp
         # 保留原有jnlp容器配置
       - name: mavenenv
         image: maven:3.6.2
         command:
           - bash
         volumeMounts:
           - name: maven-repo
             mountPath: /root/.m2/repository # Maven默认构件存储路径
   

3. Jenkinsfile无需额外修改
   声明式流水线通过yamlFile指定Pod配置，只需确保修改后的BuildPod.yaml生效即可。

方案优势 #

• 持久化存储，依赖不会随Pod销毁丢失
• 支持多节点、多流水线共享缓存，大幅减少重复下载时间
• 完全兼容Jenkins声明式流水线，配置逻辑清晰

二、替代方案 #

如果无法使用PV/PVC（比如没有存储资源权限），可以根据场景选择以下方案：

1. Jenkins Maven集成插件缓存 #

使用Pipeline Maven Integration Plugin，将依赖缓存到Jenkins主节点或指定缓存节点，适合无PV/PVC权限的场景。

修改Jenkinsfile配置：

pipeline {
  agent {
    kubernetes {
      yamlFile 'ci-cd/BuildPod.yaml'
    }
  }
  tools {
    maven 'Maven-3.6.2' // 提前在Jenkins全局配置中定义好的Maven安装
  }
  stages {
    stage('Build') {
      steps {
        withMaven(mavenLocalRepo: '.repository') {
          sh 'mvn clean install'
        }
      }
    }
  }
}

插件会自动将本地缓存同步到Jenkins的全局缓存，后续构建可直接复用。

2. 自定义预加载依赖的Maven镜像 #

如果项目依赖变动不频繁，可以构建一个包含常用依赖的自定义Maven镜像，将.m2/repository打包进镜像，彻底避免每次构建下载依赖。

示例Dockerfile：

FROM maven:3.6.2
# 复制项目pom.xml到临时目录
COPY pom.xml /tmp/pom.xml
# 提前下载所有依赖
RUN cd /tmp && mvn dependency:go-offline
# 将依赖复制到镜像固定目录
RUN cp -r /root/.m2/repository /maven-repo
# 指定Maven使用镜像内的缓存目录
ENV MAVEN_OPTS="-Dmaven.repo.local=/maven-repo"

构建镜像后，修改BuildPod.yaml中的image为自定义镜像即可。

3. Kubernetes EmptyDir临时缓存 #

EmptyDir是Pod生命周期内的临时存储，仅在Pod运行期间保留依赖，Pod销毁后缓存丢失，适合同一流水线多阶段共享依赖的场景。

修改BuildPod.yaml：

apiVersion: v1
kind: Pod
metadata:
  namespace: jenkins
  labels:
    jenkins/label: 'api-slave'
spec:
  volumes:
    - name: maven-repo
      emptyDir: {}
  containers:
    - name: jnlp
    - name: mavenenv
      image: maven:3.6.2
      command:
        - bash
      volumeMounts:
        - name: maven-repo
          mountPath: /root/.m2/repository

内容的提问来源于stack exchange，提问作者William Lake.