Ubuntu 上 Jenkins 资源分配实践
一 系统环境与关键路径
- 确认 Ubuntu 版本与 Java 环境：推荐 Ubuntu 22.04/24.04 LTS 搭配 OpenJDK 11（Jenkins LTS 常见搭配）。
- 关键目录与文件：
- Jenkins 家目录：/var/lib/jenkins
- 日志：/var/log/jenkins/jenkins.log
- 主配置：/etc/default/jenkins（Debian/Ubuntu 常用）
- 服务管理：使用 systemctl 启停与开机自启（如：sudo systemctl restart jenkins）。以上路径与配置方式在 Ubuntu 官方/社区实践中通用。
二 为 Jenkins 主进程分配 JVM 堆内存
- 编辑配置文件：sudo vim /etc/default/jenkins，在 JAVA_ARGS 中设置最大堆（Xmx）。示例将最大堆设为 4GB：
JAVA_ARGS=“-Xmx4096m”
- 重启生效：sudo systemctl restart jenkins
- 验证：ps -ef | grep jenkins 应能看到包含 -Xmx4096m 的 Java 启动参数。
- 说明：堆过小会导致 OutOfMemoryError 或构建不稳定；堆过大则可能触发长时间 GC 并挤占系统其他服务内存，需结合机器总内存与并发量调优。
三 控制并发与节点资源
- 控制并发执行器数量：在 Manage Jenkins → Configure System → Executors 设置 Executors（建议以 CPU 物理核心数为上限，留出余量给系统与其他服务）。
- 使用构建代理节点分流：在 Manage Jenkins → Manage Nodes and Clouds 添加 Agent，按标签（Label）将任务调度到不同节点，实现 CPU/内存隔离与横向扩展。
- 在任务/流水线中指定节点：通过 agent { label ‘your-label’ } 或项目配置 “Restrict where this project can be run” 实现定向调度。
- 并行阶段：在 Pipeline 中使用 parallel 将互不依赖的阶段并行执行，提高吞吐（需与节点资源匹配）。
四 Docker 部署时的资源限制
- 使用 Docker Compose 对 Jenkins 容器设置 CPU/内存上限（示例限制为 1 核 CPU、1.5GB 内存）：
version: ‘3.8’
services:
jenkins:
image: jenkins/jenkins:lts-jdk11
ports:
- “8081:8080”
- “50000:50000”
volumes:
- ./jenkins_data:/var/jenkins_home
deploy:
resources:
limits:
cpus: ‘1’
memory: ‘1500M’
- 如需在容器内使用宿主 Docker（挂载 /var/run/docker.sock），务必同时设置容器内存/CPU 上限，避免构建任务无限制扩张。
- 初始化与权限：首次启动可用 docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword 获取管理员密码；挂载目录需保证 jenkins:jenkins（UID 1000）可写。
五 监控与持续优化
- 监控手段：使用 Java VisualVM 或 JConsole 连接 Jenkins JVM，观察堆使用、线程、类加载与 GC 行为，据此微调 -Xmx 与并发度。
- 构建环境优化：
- 仅安装必要插件并定期清理；减少重型/低效插件。
- 配置 Git 等 SCM 高效拉取（浅克隆、缓存等）。
- 定期清理工作区与旧构建产物，释放磁盘空间。
- 为 Maven/Gradle 启用依赖缓存，减少重复下载。
- 架构层面：当单机资源不足时，优先引入 Agent 节点 或迁移至 Kubernetes 等弹性平台，实现按项目/队列隔离与自动扩缩。
