GitLab与Debian如何集成

在 Debian 上集成 GitLab 的实操指南

一 环境准备与安装

• 更新系统并安装依赖：sudo apt update && sudo apt upgrade -y；sudo apt install -y curl openssh-server ca-certificates tzdata perl。
• 安装邮件服务（可选但推荐）：sudo apt install postfix，安装时选择“Internet Site”。
• 添加 GitLab 官方仓库并安装：curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash；随后执行 sudo EXTERNAL_URL=“http://your_domain_or_ip” apt-get install gitlab-ce。
• 首次访问 http://your_domain_or_ip，使用管理员账户（通常为 root）设置密码。

二 核心配置与网络访问

• 配置外部地址：编辑 /etc/gitlab/gitlab.rb，设置 external_url ‘https://your_domain’（建议使用域名与 HTTPS）。
• 使配置生效：sudo gitlab-ctl reconfigure；必要时 sudo gitlab-ctl restart。
• 防火墙放行：sudo ufw allow 80/tcp；sudo ufw allow 443/tcp；sudo ufw reload。
• 反向代理与证书（两种常见方式，二选一或并存）：
  • 方式 A（内置 Nginx）：在 gitlab.rb 中开启 nginx[‘enable’] = true，配置 letsencrypt 自动证书或手动放置证书后执行 reconfigure。
  • 方式 B（外部 Nginx）：在 gitlab.rb 中设置 nginx[‘enable’] = false，配置外部 Nginx 反向代理到 http://127.0.0.1:8080（GitLab 默认 Puma 端口），示例：
    • server { listen 80; server_name your_domain; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }
    • 启用站点并重载：sudo ln -s /etc/nginx/sites-available/gitlab /etc/nginx/sites-enabled/；sudo nginx -t；sudo systemctl reload nginx。
  • 证书获取：可使用 certbot（sudo apt install certbot python3-certbot-nginx；sudo certbot --nginx -d your_domain）或 GitLab 内置 Let’s Encrypt 功能。

三 CI/CD 集成与 Runner 配置

• 安装 GitLab Runner（Debian/Ubuntu 常见方式）：curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash；sudo apt-get install gitlab-runner。
• 注册 Runner：在 GitLab 项目或实例级 Settings → CI/CD → Runners 获取注册命令与令牌，执行后选择执行器（如 shell、docker、kubernetes）。
• 启动与开机自启：sudo systemctl daemon-reload；sudo systemctl start gitlab-runner；sudo systemctl enable gitlab-runner。
• 示例 .gitlab-ci.yml（可按需扩展）：
  • stages: [build, test, deploy]
  • build: stage: build script: - echo “Building…” artifacts: paths: [build/]
  • test: stage: test script: - echo “Running tests…”
  • deploy: stage: deploy script: - echo “Deploying…” only: [master]
• 提交到仓库后，在 Pipelines 页面查看与触发。

四 安全加固与运维要点

• 资源建议：生产环境推荐至少 4–8 GB 内存、40 GB+ 磁盘，并启用监控告警。
• 备份与恢复：使用 gitlab-backup create 创建备份；恢复时使用 gitlab-backup restore 并在恢复前停止相关服务。
• 日志与排障：关键日志位于 /var/log/gitlab（如 nginx、gitlab-rails、sidekiq），结合 sudo gitlab-ctl tail 实时查看。
• 升级与维护：遵循 GitLab 官方升级路径分批升级，升级前做好全量备份与演练。
• 合规与访问控制：开启 2FA、限制 SSH/RDP 来源 IP、为管理员与 CI 账户启用最小权限与专用令牌。