Ubuntu Jenkins如何备份

Ubuntu Jenkins备份指南

一、备份前的准备工作

Jenkins在Ubuntu系统中的核心数据均集中存储在**/var/lib/jenkins**目录（称为“Jenkins主目录”），包含配置文件、作业定义、用户信息、插件及构建历史等关键数据。备份前需确保对该目录有读写权限（通常需sudo权限），并提前规划备份存储路径（如外部硬盘、云存储等），避免本地存储风险。

二、手动备份方法

1. 备份整个Jenkins主目录

通过tar命令打包整个主目录是最基础的手动备份方式，适用于一次性完整备份：

# 停止Jenkins服务（防止备份时数据写入导致不一致）
sudo systemctl stop jenkins
# 打包主目录（排除logs目录以减小体积，可选）
sudo tar -czvf jenkins_backup_$(date +%Y%m%d).tar.gz --exclude=/var/lib/jenkins/logs/* /var/lib/jenkins
# 重启Jenkins服务
sudo systemctl start jenkins

说明：--exclude参数可排除无需备份的目录（如临时日志、缓存），节省存储空间。

2. 备份关键子目录/文件

若只需备份核心数据，可选择性地打包以下目录/文件：

/var/lib/jenkins/config.xml：Jenkins全局配置文件；
/var/lib/jenkins/jobs/：所有作业的定义文件；
/var/lib/jenkins/users/：用户账户信息；
/var/lib/jenkins/plugins/：已安装插件。

sudo tar -czvf jenkins_core_backup_$(date +%Y%m%d).tar.gz \
/var/lib/jenkins/config.xml \
/var/lib/jenkins/jobs \
/var/lib/jenkins/users \
/var/lib/jenkins/plugins

适用场景：快速备份核心配置，节省时间和存储空间。

三、使用插件进行自动化备份

1. ThinBackup插件（推荐）

ThinBackup是Jenkins生态中最流行的备份插件，支持增量备份、定时任务及备份过滤，操作简便：

安装插件：登录Jenkins管理界面→“系统管理”→“插件管理”→“可选插件”→搜索“ThinBackup”→点击“安装”。
配置备份：进入“系统管理”→“ThinBackup”→“Settings”：
- 备份目录：设置备份文件存储路径（如/var/backups/jenkins）；
- 备份计划：通过Cron表达式设置定时任务（如0 2 * * *表示每天凌晨2点）；
- 排除文件：勾选无需备份的目录（如logs/、workspace/）。
执行备份：配置完成后，点击“Backup Now”即可立即备份，或等待定时任务触发。

2. Backup Plugin

Backup Plugin支持自定义备份格式（如ZIP、TAR）及远程存储（如FTP、S3），适合需要灵活存储的场景：

安装插件：同ThinBackup，搜索“Backup Plugin”并安装。
配置备份：进入“系统管理”→“Backup Plugin”→“Configure”：
- 备份目录：设置本地或远程存储路径；
- 备份频率：选择“每天”“每周”或自定义Cron表达式；
- 忽略列表：添加无需备份的文件/目录（如*.tmp）。
执行备份：通过插件界面点击“Backup Now”手动触发，或等待定时任务执行。

四、自动化备份脚本（结合Cron）

若需更灵活的备份控制（如自定义备份命名、清理旧备份），可编写Shell脚本并通过cron定时执行：

#!/bin/bash
# 定义备份目录和主目录
BACKUP_DIR="/var/backups/jenkins"
JENKINS_HOME="/var/lib/jenkins"
# 创建备份目录（若不存在）
mkdir -p $BACKUP_DIR
# 生成带时间戳的备份文件名
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_FILE="$BACKUP_DIR/jenkins_backup_$TIMESTAMP.tar.gz"
# 打包主目录（排除logs和临时文件）
tar -czvf $BACKUP_FILE -C $JENKINS_HOME . --exclude=logs --exclude=tmp
# 删除7天前的备份（保留最近7天）
find $BACKUP_DIR -name 'jenkins_backup_*' -type d -mtime +7 -exec rm -rf {} \;

设置定时任务：将脚本保存为/usr/local/bin/jenkins_backup.sh，赋予执行权限：

sudo chmod +x /usr/local/bin/jenkins_backup.sh

编辑cron任务（每天凌晨2点执行）：

sudo crontab -e

添加以下内容：

0 2 * * * /usr/local/bin/jenkins_backup.sh

五、数据库备份（可选，若使用外部数据库）

若Jenkins配置了外部数据库（如MySQL、PostgreSQL），需额外备份数据库以确保配置和作业数据的完整性：

1. MySQL数据库备份

# 导出Jenkins数据库（默认数据库名可能为'jenkins'）
mysqldump -u jenkins_user -p jenkins > jenkins_db_backup_$(date +%Y%m%d).sql

2. PostgreSQL数据库备份

# 导出Jenkins数据库（默认数据库名可能为'jenkins'）
pg_dump -U jenkins_user jenkins > jenkins_db_backup_$(date +%Y%m%d).sql

说明：需将jenkins_user替换为实际的数据库用户名，jenkins替换为数据库名。备份文件应与Jenkins主目录备份一同存储。

六、备份注意事项

备份验证：定期测试备份文件的完整性（如解压备份文件，检查配置和作业是否能正常加载），确保备份有效。
存储安全：将备份文件存储在异地（如云存储、另一台服务器），避免本地灾难（如硬盘损坏）导致数据丢失。
备份频率：根据业务需求设置备份频率（如每日增量备份+每周完整备份），平衡数据安全与存储成本。
恢复测试：每季度进行一次恢复测试，模拟故障场景（如删除主目录），验证备份文件能否成功恢复Jenkins。