ubuntu上gitlab備份恢復方法

Ubuntu系統GitLab備份恢復方法

一、GitLab備份方法

1. 準備工作

備份前需停止GitLab核心服務，確保數據一致性：

sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq

2. 手動執行完整備份

使用gitlab-rake命令備份倉庫、數據庫、用戶及配置等信息，備份文件默認存儲在/var/opt/gitlab/backups目錄：

sudo gitlab-rake gitlab:backup:create

若需立即執行（而非等待定時任務），可添加CRON=1參數：

sudo gitlab-rake gitlab:backup:create CRON=1

3. 配置備份路徑與保留時間

修改/etc/gitlab/gitlab.rb配置文件，自定義備份存儲路徑（如/data/backups/gitlab）和保留時長（如7天）：

sudo vim /etc/gitlab/gitlab.rb

添加/修改以下內容：

gitlab_rails['backup_path'] = "/data/backups/gitlab"
gitlab_rails['backup_keep_time'] = 604800  # 單位：秒（7天）

保存后重新加載配置并重啟GitLab：

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

4. 設置定時自動備份

通過crontab設置每日凌晨2點自動執行備份任務：

sudo crontab -e

添加以下行：

0 2 * * * /usr/bin/gitlab-rake gitlab:backup:create

5. 可選：增量備份（節省空間）

使用rsync同步備份目錄到遠程服務器或本地其他磁盤，排除臨時文件：

sudo rsync -avz --exclude={"/dev/*","/proc/*","/sys/*","/tmp/*","/run/*","/mnt/*","/media/*","/lost+found"} /var/opt/gitlab/ /path/to/remote/backup/

二、GitLab恢復方法

1. 準備工作

恢復前需停止GitLab相關服務，避免數據沖突：

sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq

2. 恢復完整備份

將備份文件（如gitlab_backup_1679122231_2024_06_41_13.9.7.tar）復制到備份目錄（如/var/opt/gitlab/backups），并賦予可執行權限：

sudo cp /path/to/backup/file.tar /var/opt/gitlab/backups/
sudo chmod 777 /var/opt/gitlab/backups/file.tar

執行恢復命令，指定備份文件名（無需.tar擴展名）：

sudo gitlab-rake gitlab:backup:restore BACKUP=1679122231_2024_06_41_13.9.7

3. 恢復配置與證書（若有單獨備份）

若之前備份了配置文件（/etc/gitlab/gitlab.rb）和SSL證書（/etc/gitlab/ssl），需復制回原目錄：

sudo cp /path/to/backup/gitlab.rb /etc/gitlab/gitlab.rb
sudo cp -r /path/to/backup/ssl /etc/gitlab/

4. 重啟GitLab服務

恢復完成后，重新啟動GitLab服務：

sudo gitlab-ctl start

5. 驗證恢復結果

通過GitLab Web界面登錄，檢查倉庫、用戶、權限等數據是否完整，確保實例正常運行。

三、注意事項

1. 版本一致性：恢復時GitLab版本需與備份時的版本一致，否則會提示版本不匹配錯誤。
2. 備份安全性：備份文件包含敏感信息（如用戶密碼、SSH密鑰），需存儲在加密或受保護的存儲介質中（如遠程服務器、云存儲）。
3. 定期測試恢復：每季度至少測試一次恢復流程，確保備份文件可用，避免災難發生時無法恢復數據。
4. 自動備份監控：通過郵件或日志監控定時備份任務的執行狀態，及時處理失敗情況。