如何阻止Jenkins在K8s Master节点生成.m2文件，仅在Worker节点生成

核心问题分析 #

你遇到的情况本质是Jenkins错误地将任务调度到了K8s Master节点，而非指定的Worker节点，导致.m2仓库文件被写入Master节点。主要原因可能是：

• Master节点被误打上了任务所需的zrgl-label标签
• Kubernetes云配置未限制Pod只能调度到Worker节点
• 流水线使用node()语法，绑定的是Jenkins节点而非K8s Pod的调度规则

分步解决方案 #

1. 移除Master节点的任务标签 #

登录Jenkins后台，进入Manage Jenkins -> Manage Nodes and Clouds，找到你的K8s Master节点：

• 点击节点名称进入配置页面
• 在Labels字段中，删除zrgl-label标签（如果存在）
• 保存配置，确保Master节点不再被Jenkins识别为可执行zrgl-label任务的节点

2. 禁止Master节点执行任何任务 #

直接限制Master节点的执行能力，从根源上阻止任务跑在Master上：

• 进入Master节点的配置页面
• 将# of executors设置为0
• 保存后，Master节点将不再接收任何Jenkins任务

3. 配置Kubernetes云的强制节点选择 #

在Jenkins的Kubernetes云配置中，强制Pod只能调度到Worker节点：

• 进入Manage Jenkins -> Manage Nodes and Clouds -> Configure Clouds，选择你的Kubernetes云
• 在Pod Templates下找到对应的模板，添加Node Selector：

  node-role.kubernetes.io/worker=true
  

  （如果你的集群用了自定义Worker节点标签，替换成对应标识即可）
• 保存配置，确保所有Jenkins生成的Pod只会被调度到Worker节点

4. 修正流水线的Agent配置 #

放弃node()语法，改用Kubernetes插件的原生agent语法，直接绑定Pod调度规则：

pipeline {
    agent {
        kubernetes {
            label 'zrgl-label'
            nodeSelector 'node-role.kubernetes.io/worker=true' // 强制指定Worker节点
            // 自定义Pod模板，包含构建和部署所需容器
            yaml '''
apiVersion: v1
kind: Pod
spec:
  containers:
  - name: maven
    image: maven:3.8.6-openjdk-11
    command: ["cat"]
    tty: true
    volumeMounts:
    - name: m2-repo
      mountPath: /root/.m2
  - name: kubectl
    image: bitnami/kubectl:latest
    command: ["cat"]
    tty: true
  volumes:
  - name: m2-repo
    emptyDir: {} // 用临时目录存储.m2，也可替换为PVC实现依赖缓存共享
'''
        }
    }
    stages {
        stage('Checkout') {
            cleanWs()
            withCredentials([gitUsernamePassword(credentialsId: 'zrgl.jenkins')]) {
                sh 'git clone -b <你的分支> <你的仓库地址>'
            }
        }
        stage('Build') {
            container('maven') {
                sh 'mvn clean package' // .m2文件将写入Pod内的存储，对应Worker节点资源
            }
        }
        stage('Deploy to K8s') {
            container('kubectl') {
                // 你的Kubernetes部署命令
                sh 'kubectl apply -f deployment.yaml'
            }
        }
    }
}

5. 避免直接挂载主机目录存储.m2 #

如果之前的Pod模板配置了挂载主机的.m2目录，建议改为使用K8s的emptyDir或PersistentVolumeClaim：

• emptyDir：每个Pod独享临时存储，任务结束后销毁，适合不需要持久化缓存的场景
• PVC：共享持久化存储，多个Pod可复用已下载的依赖，提升构建效率

这样既避免了.m2文件写入节点本地磁盘，也彻底杜绝了Master节点被写入的可能。

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