Debian系統中GitLab版本升級方法

Debian系統中GitLab版本升級方法

一、升級前準備工作

1. 備份數據：升級前必須備份所有關鍵數據（倉庫、配置文件、數據庫），防止升級失敗導致數據丟失。常用命令：
   sudo gitlab-rake gitlab:backup:create（默認備份路徑為/var/opt/gitlab/backups）。
2. 檢查系統兼容性：確認Debian版本與目標GitLab版本兼容（如GitLab 17.x需Debian 11/12），避免因系統不兼容導致升級中斷。
3. 更新系統包：升級Debian系統及現有軟件包，確保依賴項滿足要求：
   sudo apt update && sudo apt upgrade -y。

二、使用APT包管理器升級（推薦，適用于常規安裝）

APT是Debian系統默認的包管理工具，適用于通過GitLab官方倉庫安裝的GitLab（gitlab-ce或gitlab-ee）。

1. 更新APT包列表：同步官方倉庫的最新包信息：
   sudo apt update。
2. 升級GitLab：執行升級命令，gitlab-ce為社區版，gitlab-ee為企業版：
   sudo apt upgrade gitlab-ce 或 sudo apt upgrade gitlab-ee。
3. 重新配置與重啟：
   • 重新配置GitLab以應用新設置：sudo gitlab-ctl reconfigure（此命令會調整配置文件并初始化必要組件）。
   • 重啟GitLab服務使變更生效：sudo gitlab-ctl restart（或針對GitLab 12.5+版本使用sudo systemctl restart gitlab-runsvdir）。
4. 驗證升級結果：通過以下命令確認版本是否更新：
   sudo gitlab-rake gitlab:env:info（查看“GitLab version”字段）或訪問Web界面查看版本號。

三、手動下載安裝包升級（適用于特定版本或自定義安裝）

若需升級到官方倉庫未提供的版本（如LTS版本），可通過手動下載.deb包完成升級。

1. 備份數據：同步驟一。
2. 卸載舊版本（可選但建議）：徹底移除舊版本以避免沖突：
   sudo apt purge gitlab-ce gitlab-ce-cli gitlab-rails gitlab-shell，然后刪除殘留目錄：
   sudo rm -rf /var/opt/gitlab /etc/gitlab。
3. 下載最新安裝包：訪問GitLab官方下載頁面（https://about.gitlab.com/downloads/），選擇Debian對應版本的.deb包（如gitlab-ce_17.3.3-ce.0_amd64.deb），使用wget下載：
   wget https://packages.gitlab.com/gitlab/gitlab-ce/packages/debian/12/gitlab-ce_17.3.3-ce.0_amd64.deb/download.deb。
4. 安裝新版本：使用dpkg安裝下載的包，并自動解決依賴問題：
   sudo dpkg -i /path/to/downloaded.deb，若出現依賴錯誤，運行sudo apt install -f修復。
5. 重新配置與重啟：同步驟二中的3-4步。

四、Docker部署GitLab升級（適用于容器化環境）

若GitLab通過Docker容器運行，升級流程主要涉及鏡像拉取與容器重建。

1. 備份數據：確保Docker卷（如/srv/gitlab/config、/srv/gitlab/data）中的數據已備份。
2. 拉取最新鏡像：從Docker Hub獲取最新版GitLab CE鏡像：
   docker pull gitlab/gitlab-ce:latest。
3. 停止并移除舊容器：停止運行中的GitLab容器并刪除（數據卷不會被刪除）：
   docker stop gitlab && docker rm gitlab。
4. 啟動新容器：使用舊容器的配置（如端口映射、數據卷）啟動新容器：
   docker run --name gitlab -d -p 80:80 -p 443:443 -p 22:22 --volume /srv/gitlab/config:/etc/gitlab --volume /srv/gitlab/logs:/var/log/gitlab --volume /srv/gitlab/data:/var/opt/gitlab gitlab/gitlab-ce:latest。
5. 驗證升級：訪問Web界面或運行docker exec gitlab gitlab-rake gitlab:env:info確認版本。

五、升級注意事項

1. 停機時間：單節點GitLab升級期間，服務將不可用，建議在低峰期操作并提前通知用戶。
2. 依賴問題：手動升級時，若遇到依賴錯誤，sudo apt install -f可自動安裝缺失的依賴。
3. 配置文件檢查：升級后需檢查/etc/gitlab/gitlab.rb中的配置（如external_url），確保與新版本兼容。
4. 哈希存儲遷移：若從舊版本（<10.0）升級到啟用哈希存儲的新版本，需運行sudo gitlab-rake gitlab:storage:migrate_to_hashed遷移存儲庫，此操作耗時較長且需停機。
5. glibc兼容性：若升級操作系統glibc版本（如從2.27升至2.28），需提前備份PostgreSQL數據，避免因庫版本不兼容導致數據庫損壞。