背景

Jenkins作为广泛使用的持续集成/持续部署（CI/CD）工具，在频繁构建过程中会积累大量缓存文件，包括工作空间、构建历史、插件缓存、Maven/Gradle依赖等。这些缓存若不及时清理，会迅速耗尽磁盘空间，影响构建性能甚至导致系统不可用。本文针对IDC环境中的Jenkins实例，提供系统化的缓存清理方法，帮助运维人员高效管理磁盘占用。

为什么必须清理Jenkins缓存

长时间运行的Jenkins主节点或代理节点，其磁盘占用主要来自以下方面：

• 工作空间（Workspace）：每次构建都会拉取代码、编译产物，默认不自动清理。
• 构建历史（Build Records）：包括构建日志、归档文件、测试报告等。
• 插件及工具缓存：如Maven本地仓库（~/.m2）、npm缓存、Docker镜像层等。
• 临时文件：管道中生成的中间文件、JENKINS_HOME下的tmp目录。

磁盘占用过高会降低构建速度，甚至触发“磁盘空间不足”错误，导致构建失败。定期清理是保持Jenkins稳定运行的关键维护操作。

清理方法

1. 手动清理工作空间

通过Jenkins Web界面：进入每个任务，点击“工作空间”后选择“清除工作空间”。或使用脚本对多任务批量清理。

2. 配置自动清理策略

在任务配置中启用“丢弃旧的构建”，设置保留天数或构建数量。同时可启用“自定义工作空间清理”插件（如Workspace Cleanup Plugin）来在构建前后删除工作空间。

3. 清理Jenkins主目录缓存

进入$JENKINS_HOME目录，删除以下子目录中的过时内容：

• jobs/任务名/builds/：只保留最近若干构建的目录。
• plugins/：未使用的插件可手动删除，但需注意依赖。
• userContent/：清理无用文件。
• logs/：定期归档或删除过期日志。

4. 清理第三方工具缓存

对于Maven构建，可删除~/.m2/repository中的未依赖版本；对于npm，执行npm cache clean --force；对于Docker镜像，定期移除未使用的镜像和构建缓存（docker system prune）。

5. 使用Jenkins CLI或API远程清理

通过编写Shell脚本调用Jenkins API或Jenkins CLI命令，实现自动化清理。例如：curl -X POST http://jenkins-url/job/任务名/doDelete。

最佳实践

• 设定磁盘告警阈值：在IDC监控系统中设置Jenkins磁盘使用率告警（如>80%），提前触发清理流程。
• 定期执行清理作业：创建独立的Jenkins任务（如“系统-磁盘清理”），配置定时触发，运行清理脚本。
• 分离构建与存储：将工作空间目录挂载到独立磁盘，避免影响Jenkins主程序所在分区。
• 备份后再清理：重要构建日志或产物应先备份或归档，避免误删关键数据。

结语

通过以上方法，IDC运维人员可以有效控制Jenkins的磁盘占用，保障构建效率与系统稳定性。建议根据实际构建频率和存储容量，制定周期性的清理计划，并纳入日常运维巡检清单。