GitLab在Debian上的使用教程与最佳实践

一、安装与配置

1. 安装前准备

   • 更新系统：sudo apt update && sudo apt upgrade。
   • 安装依赖：sudo apt install curl openssh-server ca-certificates tzdata perl。
   • 添加官方仓库：curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash。

2. 安装GitLab

   • 执行安装命令（替换为你的IP/域名）：
     sudo EXTERNAL_URL="http://your_server_ip" apt install gitlab-ce。
   • 安装过程中可设置管理员密码和域名。

3. 配置与启动

   • 编辑配置文件 /etc/gitlab/gitlab.rb，确认 external_url 正确。
   • 重新配置并重启：sudo gitlab-ctl reconfigure && sudo gitlab-ctl restart。
   • 开放防火墙端口（UFW）：sudo ufw allow 80 443。

4. 首次访问

   • 浏览器输入 http://your_server_ip，使用管理员账号密码登录（初始密码在 /etc/gitlab/initial_root_password）。

二、最佳实践

1. 安全配置

   • 启用HTTPS：在 /etc/gitlab/gitlab.rb 中设置 external_url 'https://your_domain'，并配置SSL证书（支持Let’s Encrypt）。
   • 配置SSH密钥：在用户设置中添加公钥，避免密码认证。
   • 定期备份：使用 gitlab-backup create 命令备份数据，建议每日一次。

2. 性能优化

   • 分配足够资源：确保服务器至少2GB内存、20GB磁盘空间。
   • 使用国内镜像：修改仓库源为清华镜像（需在安装前配置）。

3. 项目管理

   • 分支策略：采用GitFlow或简化分支模型，避免直接在主分支修改代码。
   • 频繁提交：小步提交，保持提交信息清晰（如“修复登录bug”）。
   • CI/CD集成：在项目根目录创建 .gitlab-ci.yml，定义自动化构建、测试流程（如示例中构建、测试、部署阶段）。

4. 监控与维护

   • 查看日志：通过 sudo gitlab-ctl tail 监控服务日志，及时发现异常。
   • 更新系统：定期执行 sudo apt update && sudo apt upgrade，安装安全补丁。

三、常用命令

• 启动/停止服务：sudo gitlab-ctl start/stop/restart。
• 查看状态：sudo gitlab-ctl status。
• 备份数据：sudo gitlab-backup create。
• 恢复数据：sudo gitlab-backup restore force=yes。

以上步骤参考自，可根据实际需求调整配置。