我们在开发项目的时候使用Jenkins进行自动化构建，能够提高我们的打包部署效率，但使用时间久了，服务器磁盘空间就会堆满，报“jenkins Disk space is below threshold of 1.00 GiB. Only 361.88 MiB out of 99.97 GiB left on /home/jenkins.”错误。我们如何解决这个问题了？本文将详细阐述。
一、立即释放磁盘空间
适用于紧急处理
# (1) 清理 Docker 无用资源 (适用于容器化部署)
docker system prune -a --volumes --force
# (2) 清理 Jenkins 工作空间历史记录
# 进入 Jenkins 容器或主机
cd /home/jenkins/jenkins_home/jobs/
find . -type d -name "builds" -exec rm -rf {}/* \; # 保留目录结构仅删除内容
# (3) 删除超大日志文件
find /home/jenkins_jdk17 -type f -name "*.log*" -size +100M -exec rm -f {} \;二、诊断磁盘占用根源
# (1) 可视化分析磁盘占用 (安装 ncdu 工具)
sudo apt install ncdu -y && ncdu /home/jenkins_jdk17
# (2) 检查 Docker 存储占用
docker system df -v
# (3) 定位 Jenkins 大文件分布
du -h --max-depth=1 /home/jenkins_jdk17/jenkins_home | sort -hr三、针对性清理策略
1.Jenkins 专用清理
# (1) 按时间清理构建历史 (保留最近10次)
cd /home/jenkins_jdk17/jenkins_home/jobs/
find . -path "*/builds/*" -type d -mtime +7 -exec rm -rf {} \; # 删除7天前的构建
# (2) 清理 workspace 残留
find /home/jenkins_jdk17/jenkins_home/workspace/ -name "@tmp" -type d -mtime +1 -exec rm -rf {} \;2.Docker专项优化
# (1) 限制容器日志大小 (全局配置)
sudo tee /etc/docker/daemon.json <<EOF
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
EOF
systemctl restart docker
# (2) 清理 dangling 镜像
docker images -q -f dangling=true | xargs docker rmi四、长期预防方案
Jenkins 配置优化
安装插件
ThinBackup：增量备份与清理
Disk Usage：实时监控
全局配置
进入 Manage Jenkins → System Configuration
设置构建保留策略：
Max # of builds to keep = 10
Days to keep builds = 7
自动化运维脚本
创建定时清理任务 (/etc/cron.daily/jenkins_cleanup)：
#!/bin/bash
# 清理 30 天前的构建记录
find /home/jenkins_jdk17/jenkins_home/jobs/ -path "*/builds/*" -type d -mtime +30 -delete
# 清理临时工作空间
find /home/jenkins_jdk17/jenkins_home/workspace/ -name "@tmp" -type d -mtime +1 -exec rm -rf {} \;
# 清理 Docker 日志
find /var/lib/docker/containers/ -name "*.log" -size +50M -exec truncate -s 0 {} \;存储扩容方案
# (1) 使用 LVM 动态扩展分区
sudo lvextend -L +50G /dev/mapper/ubuntu--vg-home
sudo resize2fs /dev/mapper/ubuntu--vg-home
# (2) 或迁移 Jenkins 数据目录
sudo systemctl stop jenkins
rsync -avz /home/jenkins_jdk17 /new/storage/
sudo ln -sf /new/storage/jenkins_jdk17 /home/jenkins_jdk17
sudo systemctl start jenkins五、监控与告警增强
# Prometheus 告警规则示例 (prometheus.rules.yml)
- alert: JenkinsLowDiskSpace
expr: (node_filesystem_avail_bytes{mountpoint="/home/jenkins_jdk17"} / node_filesystem_size_bytes{mountpoint="/home/jenkins_jdk17"}) * 100 < 10
for: 15m
labels:
severity: critical
annotations:
summary: "Jenkins 存储空间不足 (实例 {{ $labels.instance }})"
description: "挂载点 /home/jenkins_jdk17 剩余空间仅剩 {{ printf \"%.2f\" (100 - (node_filesystem_avail_bytes{mountpoint=\"/home/jenkins_jdk17\"} / node_filesystem_size_bytes{mountpoint=\"/home/jenkins_jdk17\"}) * 100) }}%"六、关键总结
- 优先清理 workspace/@tmp 和 builds/ 目录，这些是主要空间占用源
- 对于容器化部署，日志轮转配置比物理机环境更重要
- 当存储使用率持续 >80% 时，应考虑横向扩展存储而非单纯清理