Debian GitLab更新和维护指南

一、更新前准备

1. 备份数据
   使用 sudo gitlab-rake gitlab:backup:create 备份数据库、配置文件和仓库数据。
2. 检查系统状态
   确保系统已更新至最新版本：sudo apt update && sudo apt upgrade。
3. 确认版本兼容性
   避免跨多版本升级（如从13.6直接升级到13.8），单节点仅支持逐小版本升级。

二、更新操作步骤

方法一：使用官方脚本（推荐）

1. 下载并运行升级脚本：

   wget https://packages.gitlab.com/gitlab/gitlab-ce/script.deb.sh  
   sudo bash script.deb.sh  
   

2. 重启服务：

   sudo gitlab-ctl restart  
   

方法二：手动更新

1. 移除旧版本：

   sudo apt-get purge gitlab-ce  
   sudo rm -rf /var/opt/gitlab /etc/gitlab  
   

2. 添加官方仓库并安装新版本：

   curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash  
   sudo apt-get install gitlab-ce  
   

3. 重新配置并重启：

   sudo gitlab-ctl reconfigure  
   sudo gitlab-ctl restart  
   

Docker部署更新

1. 拉取最新镜像：

   docker pull gitlab/gitlab-ce:latest  
   

2. 停止并删除旧容器，重新运行新容器（需挂载数据卷）：

   docker stop gitlab && docker rm gitlab  
   docker run --name gitlab -p 80:80 -p 443:443 -v /srv/gitlab:/var/opt/gitlab -d gitlab/gitlab-ce:latest  
   

三、更新后验证

1. 检查版本：

   sudo gitlab-rake gitlab:env:info  
   

2. 验证服务状态：

   sudo gitlab-ctl status  
   

3. 访问Web界面确认功能正常。

四、维护建议

1. 定期备份
   每周至少备份一次，建议使用自动化脚本或工具。
2. 监控与日志
   通过 sudo gitlab-rake gitlab:check 检查配置健康度，监控 /var/log/gitlab 日志。
3. 安全加固
   • 启用HTTPS并定期更新SSL证书。
   • 限制SSH访问，使用双因素认证。
4. 性能优化
   定期清理冗余数据，调整 gitlab.rb 中的资源分配参数（如内存、CPU）。

五、注意事项

• 停机时间：单节点升级可能导致短暂服务中断，建议在低峰期操作。
• 依赖问题：手动升级时需确保系统依赖（如PostgreSQL、Nginx）版本兼容。
• 回滚策略：若升级失败，可通过备份恢复至旧版本。

参考来源：