本地私有GitLab搭建：定时备份

原创于 2025-12-22 15:08:37 发布 · 373 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#ubuntu #linux #运维

云原生专栏收录该内容

32 篇文章

订阅专栏

在GitLab中实现定时备份非常重要，可以确保您的代码和数据安全。下面我为您详细介绍几种主流的备份方案。

🔄 备份方案概览

以下是GitLab定时备份的几种主要方法对比，您可以根据自己的需求选择：

方案	适用场景	优点	缺点
系统Cron任务	简单的定时备份需求	配置简单，系统原生支持	需要手动管理日志和错误处理
GitLab内置配置	希望备份与GitLab深度集成	配置一次即可，无需额外脚本	灵活性相对较低
自定义备份脚本	需要复杂备份逻辑和错误处理	完全可控，功能强大	需要一定的脚本编写能力

下面是这几种方案的详细实现方法：

1. 使用系统Cron任务（推荐方案）

这是最直接和可靠的方法，适合大多数场景。

创建备份脚本

首先创建一个备份脚本 /home/gitlab-backup.sh：

#!/bin/bash
# GitLab自动备份脚本

# 设置变量
BACKUP_DIR="/var/opt/gitlab/backups"
LOG_FILE="/var/log/gitlab/backup.log"
DATE=$(date +%Y-%m-%d-%H-%M-%S)

# 创建日志目录（如果不存在）
mkdir -p /var/log/gitlab

# 执行备份并记录日志
echo "[$DATE] 开始GitLab备份..." >> $LOG_FILE

# 进入容器执行备份命令
sudo docker exec gitlab gitlab-backup create >> $LOG_FILE 2>&1

# 检查备份是否成功
if [ $? -eq 0 ]; then
    echo "[$DATE] 备份成功完成" >> $LOG_FILE
    
    # 可选：清理旧备份（保留最近7天）
    find $BACKUP_DIR -name "*.tar" -mtime +7 -delete >> $LOG_FILE 2>&1
    echo "[$DATE] 已清理7天前的旧备份" >> $LOG_FILE
else
    echo "[$DATE] 备份失败！请检查日志" >> $LOG_FILE
    # 可以在这里添加邮件或钉钉通知
fi

设置脚本权限并测试

# 给脚本执行权限
chmod +x /home/gitlab-backup.sh

# 测试脚本
sudo /home/gitlab-backup.sh

# 查看备份文件
sudo ls -la /srv/gitlab/data/backups/

配置Cron定时任务

# 编辑cron任务
sudo crontab -e

# 添加以下行（每天凌晨2点执行备份）
0 2 * * * /home/gitlab-backup.sh

# 查看cron任务
sudo crontab -l

2. 使用GitLab内置配置（容器部署）

通过修改GitLab配置文件实现自动备份。

修改GitLab配置文件

编辑 /srv/gitlab/config/gitlab.rb：

# 启用定时备份
gitlab_rails['backup_keep_time'] = 604800  # 保留7天（秒）
gitlab_rails['backup_archive_permissions'] = 0644

# 设置备份时间（每天凌晨2点）
gitlab_rails['backup_cron_enable'] = true
gitlab_rails['backup_cron_minute'] = "0"
gitlab_rails['backup_cron_hour'] = "2"

# 可选：配置远程备份到云存储
# gitlab_rails['backup_upload_connection'] = {
#   'provider' => 'AWS',
#   'region' => 'us-east-1',
#   'aws_access_key_id' => 'YOUR_KEY',
#   'aws_secret_access_key' => 'YOUR_SECRET'
# }
# gitlab_rails['backup_upload_remote_directory'] = 'my-gitlab-backups'

应用配置

# 进入容器重新配置
sudo docker exec -it gitlab gitlab-ctl reconfigure
sudo docker exec -it gitlab gitlab-ctl restart

3. 高级：完整备份脚本（包含配置和数据库）

创建更完整的备份脚本，包含配置文件和关键数据：

#!/bin/bash
# 完整GitLab备份脚本

BACKUP_DIR="/srv/gitlab/backups"
DATE=$(date +%Y-%m-%d-%H-%M-%S)
LOG_FILE="/var/log/gitlab/backup.log"

echo "[$DATE] 开始完整GitLab备份..." >> $LOG_FILE

# 1. 备份GitLab数据
echo "[$DATE] 备份GitLab数据..." >> $LOG_FILE
sudo docker exec gitlab gitlab-backup create >> $LOG_FILE 2>&1

# 2. 备份配置文件
echo "[$DATE] 备份配置文件..." >> $LOG_FILE
sudo tar -czf $BACKUP_DIR/gitlab-config-$DATE.tar.gz -C /srv/gitlab/config . >> $LOG_FILE 2>&1

# 3. 备份SSL证书（如果存在）
if [ -d "/srv/gitlab/config/ssl" ]; then
    echo "[$DATE] 备份SSL证书..." >> $LOG_FILE
    sudo tar -czf $BACKUP_DIR/gitlab-ssl-$DATE.tar.gz -C /srv/gitlab/config/ssl . >> $LOG_FILE 2>&1
fi

# 4. 验证备份完整性
if [ $? -eq 0 ]; then
    echo "[$DATE] ✓ 备份成功完成" >> $LOG_FILE
    
    # 清理30天前的旧备份
    find $BACKUP_DIR -name "*.tar" -mtime +30 -delete >> $LOG_FILE 2>&1
    find $BACKUP_DIR -name "*.tar.gz" -mtime +30 -delete >> $LOG_FILE 2>&1
    
    # 可选：发送成功通知
    echo "GitLab备份已完成于 $DATE" | mail -s "GitLab备份成功" admin@example.com
else
    echo "[$DATE] ✗ 备份失败！" >> $LOG_FILE
    # 发送失败通知
    echo "GitLab备份失败于 $DATE，请检查日志" | mail -s "GitLab备份失败" admin@example.com
fi

🔍 备份验证和恢复测试

定期验证备份的有效性至关重要：

验证备份完整性

# 列出可用的备份
sudo docker exec gitlab ls -la /var/opt/gitlab/backups/

# 检查备份文件大小（应该大于1MB）
sudo du -sh /srv/gitlab/data/backups/*.tar

测试恢复流程（在测试环境）

# 停止相关服务
sudo docker exec gitlab gitlab-ctl stop unicorn
sudo docker exec gitlab gitlab-ctl stop sidekiq

# 执行恢复（将YYYYMMDD替换为实际备份日期）
sudo docker exec gitlab gitlab-backup restore BACKUP=YYYYMMDD

# 重新配置并启动
sudo docker exec gitlab gitlab-ctl reconfigure
sudo docker exec gitlab gitlab-ctl restart

⚠️ 重要注意事项

存储空间监控：确保备份目录有足够空间
备份文件权限：备份文件应设置为仅管理员可访问
异地备份：重要数据应定期复制到异地或云存储
恢复测试：每季度至少进行一次恢复测试

📊 监控备份状态

设置监控确保备份正常执行：

# 检查最近备份时间
sudo tail -n 20 /var/log/gitlab/backup.log

# 检查备份文件最新修改时间
sudo find /srv/gitlab/data/backups -name "*.tar" -mtime -1

选择适合您环境的方案，建议从**方案一（Cron任务）**开始，它最灵活且易于调试。记得定期测试恢复流程，确保在真正需要时备份能够正常工作！