Ubuntu GitLab更新后如何遷移數據

Ubuntu GitLab更新后數據遷移指南

一、遷移前準備

1. 備份所有關鍵數據
   使用GitLab內置工具創建完整備份，包含倉庫、用戶信息、CI/CD配置、問題跟蹤等：

   sudo gitlab-rake gitlab:backup:create
   

   備份文件默認存儲在/var/opt/gitlab/backups目錄，文件名格式為YYYY-MM-DD-HH-mm-ss_gitlab_backup.tar。
2. 停止GitLab相關服務
   避免遷移過程中數據寫入導致不一致，停止核心服務：

   sudo gitlab-ctl stop unicorn
   sudo gitlab-ctl stop sidekiq
   sudo gitlab-ctl stop nginx  # 可選，若涉及web配置變更
   

二、安裝新版本GitLab（若未完成）

若遷移至全新服務器或需要全新安裝，需先通過Omnibus包安裝最新版GitLab：

# 導入GitLab GPG密鑰
curl https://packages.gitlab.com/gpg.key | sudo apt-key add -
# 添加GitLab軟件源
echo "deb https://packages.gitlab.com/gitlab/gitlab-ce/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/gitlab.list
# 更新包索引并安裝
sudo apt-get update
sudo apt-get install gitlab-ce

安裝完成后，通過sudo gitlab-ctl reconfigure應用初始配置。

三、遷移核心數據

1. 遷移備份文件

將舊服務器/var/opt/gitlab/backups目錄下的備份文件復制到新服務器相同路徑：

scp -r user@old-server:/var/opt/gitlab/backups/* user@new-server:/var/opt/gitlab/backups/

2. 恢復備份數據

在新服務器上，使用GitLab恢復工具導入備份（需停止相關服務）：

sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq
sudo gitlab-rake gitlab:backup:restore BACKUP=2025-09-18-12-00-00  # 替換為實際備份文件名（不含.tar后綴）

3. 遷移倉庫與配置文件（可選，若備份未覆蓋）

若備份不完整，手動復制倉庫目錄（存儲代碼倉庫）及配置、附件目錄：

# 復制倉庫（默認路徑）
sudo rsync -avz /var/opt/gitlab/repositories/ user@new-server:/var/opt/gitlab/
# 復制配置文件（含gitlab.rb）
sudo rsync -avz /var/opt/gitlab/config/ user@new-server:/var/opt/gitlab/
# 復制共享文件（含附件、LFS對象等）
sudo rsync -avz /var/opt/gitlab/shared/ user@new-server:/var/opt/gitlab/

四、更新配置與重啟服務

1. 檢查配置文件
   編輯/etc/gitlab/gitlab.rb，確認關鍵配置（如外部URL、數據庫連接）是否適配新環境：

   external_url 'http://new-server-ip'  # 更新為新服務器地址
   gitlab_rails['gitlab_shell_ssh_port'] = 22  # 若SSH端口變更需調整
   

2. 重新配置GitLab
   應用配置變更：

   sudo gitlab-ctl reconfigure
   

3. 啟動GitLab服務
   啟動所有服務并設置開機自啟：

   sudo gitlab-ctl start
   sudo gitlab-ctl enable
   

五、驗證遷移結果

1. 訪問Web界面
   通過瀏覽器訪問http://new-server-ip，確認登錄頁面正常顯示。
2. 檢查數據完整性
   • 登錄GitLab，驗證用戶、項目、CI/CD配置是否存在。
   • 進入任意項目，檢查代碼倉庫是否能正?？寺?、推送。
   • 查看問題跟蹤、Wiki等模塊，確認數據無丟失。

注意事項

• 測試環境演練：生產環境遷移前，務必在測試服務器上模擬流程，避免誤操作。
• 版本兼容性：確保新版本GitLab與舊版本數據格式兼容（參考官方升級文檔）。
• 定期備份：遷移后設置自動備份策略（如每日增量備份），防止數據丟失。
• 監控性能：遷移后觀察新服務器資源占用（CPU、內存、磁盤），確保滿足GitLab運行需求。