当团队规模扩大到几十个微服务、几十条流水线时，单个 Jenkins Agent 就成了瓶颈——构建排队、资源争抢、环境冲突。本篇讲清楚如何规划多节点构建集群，让构建任务高效分发到合适的 Agent 上。

单节点场景：
  10个流水线同时触发 → 排队 → 第1个跑完(15分钟) → 第2个开始...
  → 最后一个等了150分钟才开始

多节点场景：
  10个流水线 → 分散到5个Agent → 每个节点跑2个 → 30分钟全部完成

| 按技术栈分组 | Java 节点、Go 节点、前端节点分离 |

| 按任务类型分组 | 构建节点、部署节点、测试节点分离 |

| 按环境隔离 | 生产部署节点与构建节点网络隔离 |

| 按负载弹性 | 基础节点常驻 + 弹性节点按需扩缩 |

命名规则: <技术栈>-<任务类型>-<序号>

示例标签:
  java-build-01     # Java 构建
  java-build-02
  go-build-01       # Go 构建
  frontend-build-01 # 前端构建
  docker-build-01   # Docker 镜像构建
  k8s-deploy-01     # K8s 部署（有 kubectl）
  k8s-deploy-02
  e2e-test-01       # E2E 测试（有浏览器）

在 Manage Jenkins → Nodes → 节点配置中设置 Labels：

agent-java-build-01:
  Labels: java-build,maven,gradle
  # 多个标签用逗号分隔，Pipeline 中可以用任意一个匹配

agent-docker-build-01:
  Labels: docker-build,docker
  # 这个节点有 Docker daemon

agent-k8s-deploy-01:
  Labels: k8s-deploy,kubectl
  # 这个节点有 kubectl 和集群 kubeconfig

pipeline {
    // 精确匹配：必须有 java-build 标签
    agent { label 'java-build' }
    
    stages {
        stage('Build') {
            steps { sh 'mvn clean package' }
        }
        
        stage('Docker Build') {
            // 切换到有 docker 标签的节点
            agent { label 'docker-build' }
            steps {
                sh 'docker build -t myapp:${BUILD_NUMBER} .'
                sh 'docker push registry.com/myapp:${BUILD_NUMBER}'
            }
        }
        
        stage('Deploy') {
            // 切换到有 k8s-deploy 标签的节点
            agent { label 'k8s-deploy' }
            steps {
                sh 'kubectl set image deployment/myapp app=registry.com/myapp:${BUILD_NUMBER} -n prod'
                sh 'kubectl rollout status deployment/myapp -n prod'
            }
        }
    }
}

pipeline {
    agent { label 'java-build' }
    
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package -DskipTests'
                // 打包产物
                stash includes: 'target/*.jar', name: 'app-jar'
            }
        }
        
        stage('Docker Build') {
            agent { label 'docker-build' }
            steps {
                // 取回产物
                unstash 'app-jar'
                sh 'docker build -t myapp:${BUILD_NUMBER} .'
                sh 'docker push registry.com/myapp:${BUILD_NUMBER}'
            }
        }
        
        stage('Deploy') {
            agent { label 'k8s-deploy' }
            steps {
                sh "kubectl set image deployment/myapp app=registry.com/myapp:${BUILD_NUMBER} -n prod"
            }
        }
    }
}

固定 5 个 Agent → 平时利用率 20% → 浪费资源
                  上线日不够用 → 构建排队

Pod 按需创建 → 高峰期自动扩容到 20 个
              空闲期自动缩到 0
              每次构建都是全新环境 → 无环境污染

Manage Jenkins → System → Cloud → Kubernetes：

# 关键配置
Kubernetes URL: https://k8s-api:6443
Kubernetes Namespace: jenkins
Jenkins URL: http://jenkins-master:8080
Jenkins tunnel: jenkins-master:50000

# Pod Template 配置:
Name: maven-pod
Namespace: jenkins
Labels: k8s-maven
# Container Template:
  Name: maven
  Docker image: maven:3.9-eclipse-temurin-17
  Command: cat
  Working directory: /home/jenkins/agent
  # 资源限制:
    CPU request: 1
    CPU limit: 2
    Memory request: 2Gi
    Memory limit: 4Gi
  # Volume:
    /root/.m2 → PVC(maven-cache)

pipeline {
    agent {
        kubernetes {
            label 'maven-pod'
            yaml '''
apiVersion: v1
kind: Pod
spec:
  containers:
  - name: maven
    image: maven:3.9-eclipse-temurin-17
    command: ['cat']
    tty: true
    volumeMounts:
    - name: maven-cache
      mountPath: /root/.m2
  - name: docker
    image: docker:24
    command: ['cat']
    tty: true
    securityContext:
      privileged: true  # 需要构建 Docker 镜像
  volumes:
  - name: maven-cache
    persistentVolumeClaim:
      claimName: maven-cache-pvc
  - name: docker-sock
    hostPath:
      path: /var/run/docker.sock
'''
        }
    }
    
    stages {
        stage('Build') {
            steps {
                container('maven') {
                    sh 'mvn clean package -DskipTests'
                    stash includes: 'target/*.jar', name: 'app-jar'
                }
            }
        }
        
        stage('Docker Build') {
            steps {
                container('docker') {
                    unstash 'app-jar'
                    sh 'docker build -t myapp:${BUILD_NUMBER} .'
                    sh 'docker push registry.com/myapp:${BUILD_NUMBER}'
                }
            }
        }
    }
}

// AND 表达式：同时拥有两个标签
agent { label 'java && docker' }

// OR 表达式：任一标签
agent { label 'java-build || go-build' }

// 排除表达式
agent { label 'build && !e2e-test' }

| Load | 优先选负载低的 | Node 配置 → Usage → "Use this node as much as possible" |

// 在 Job 配置中设置优先级
properties([
    buildDiscarder(logRotator(numToKeepStr: '20')),
    [$class: 'JiraProjectProperty'],
    pipelineTriggers([cron('@daily')])
])

// 通过 Priority Sorter 插件设置优先级
// 安装 Priority Sorter Plugin 后：
// Manage Jenkins → System → Priority Sorter
//   → Priority Strategy → Absolute Priority
//   → Job Group: 
//     - 'deploy-*' → Priority 1 (最高)
//     - 'build-*' → Priority 5
//     - 'test-*' → Priority 10

避免多个 Job 同时操作同一资源：

pipeline {
    agent any
    options {
        // 同一资源组同时只允许一个构建
        lock(resource: 'production-deploy', inversePrecedence: true)
    }
    stages {
        stage('Deploy') {
            steps {
                sh 'kubectl apply -f deploy/ -n prod'
            }
        }
    }
}

#!/bin/bash
# 定期检查所有 Agent 的磁盘空间
for agent in $(java -jar jenkins-cli.jar -s http://localhost:8080 list-nodes 2>/dev/null | awk '{print $1}'); do
    DISK_USAGE=$(java -jar jenkins-cli.jar -s http://localhost:8080 node $agent run-script 'println "df -h".execute().text' 2>/dev/null | grep '/$' | awk '{print $5}' | tr -d '%')
    
    if [ "$DISK_USAGE" -gt 80 ]; then
        echo "WARNING: Agent $agent disk usage: ${DISK_USAGE}%"
        # 推送到 Prometheus
        echo "jenkins_agent_disk_usage{agent=\"$agent\"} $DISK_USAGE" | curl --data-binary @- http://pushgateway:9091/metrics/job/jenkins-agent
    fi
done

# 定时清理 Agent 上的旧构建产物
#!/bin/bash
# 在每个 Agent 上配置 crontab
find /home/jenkins/workspace -mindepth 1 -maxdepth 1 -type d -mtime +7 -exec rm -rf {} \;
find /tmp -name "jenkins*" -mtime +1 -exec rm -f {} \;
docker system prune -f --filter "until=24h"

：《插件生态：必装插件清单与安全加固》——盘点 Jenkins 生态中真正好用的插件，以及如何避免"插件地狱"。

前言 当团队规模扩大到几十个微服务、几十条流水线时，单个 Jenkins Agent 就成了瓶颈——构建排队、资源争抢、环境冲突。本篇讲清楚如何规划多节点构建集群，让构建任务高效分发到合适的 Agent 上。 一、为什么需要多节点 单节点的瓶颈 单节点场景： 10个流水线同时触发 → 排队 → 第1个跑完15分钟 → 第2个开始... → 最后一个等了150分钟才开始 多节点场景： 10个流水线 ...

【CI/CD·Jenkins篇】多节点构建：Agent 配置与任务分发策略

研发部经理

人工智能

构建高效Jenkins多节点集群，需按技术栈与任务类型规划Agent标签，实现精准分发。跨节点产物传递用stash/unstash，避免工作空间切换问题。Kubernetes动态Agent按需扩缩，注意设置idleMinutes防止Pod回收。通过标签表达式、负载均衡策略及lock指令优化任务调度，并监控Agent健康状态，定期清理旧产物。

负载均衡

Kubernetes

Agent

Java

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

构建高效Jenkins多节点集群，需按技术栈与任务类型规划Agent标签，实现精准分发。跨节点产物传递用stash/unstash，避免工作空间切换问题。Kubernetes动态Agent按需扩缩，注意设置idleMinutes防止Pod回收。通过标签表达式、负载均衡策略及lock指令优化任务调度，并监控Agent健康...

【CI/CD·Jenkins篇】多节点构建：Agent 配置与任务分发策略

【CI/CD·Jenkins篇】多节点构建：Agent 配置与任务分发策略

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐