Debian与GitLab集成怎样实现

Debian与GitLab集成实现指南

一 环境准备与安装

• 更新系统并安装依赖：sudo apt update && sudo apt upgrade -y；sudo apt install -y curl openssh-server ca-certificates tzdata perl。可选安装邮件服务：sudo apt install -y postfix（用于通知与找回密码）。
• 添加 GitLab 官方 APT 仓库并安装：curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash；sudo apt install gitlab-ce。安装时或安装后通过 EXTERNAL_URL 指定访问地址，例如：sudo EXTERNAL_URL=“http://your_domain_or_ip” apt install gitlab-ce。
• 首次配置与启动：编辑 /etc/gitlab/gitlab.rb，设置 external_url；执行 sudo gitlab-ctl reconfigure 使配置生效；如需开机自启，启用 gitlab-runsvdir 服务：sudo systemctl enable gitlab-runsvdir。

二 网络访问与安全配置

• 防火墙放行：sudo ufw allow 80/tcp；sudo ufw allow 443/tcp；sudo ufw reload（如启用 UFW）。
• 使用外部 Nginx 反向代理（可选）：在 /etc/nginx/sites-available/gitlab 配置反向代理，示例：
  server { listen 80; server_name your_domain; location / { proxy_pass http://gitlab_rails; 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; } }
  启用站点并重启 Nginx：sudo ln -s /etc/nginx/sites-available/gitlab /etc/nginx/sites-enabled/；sudo nginx -t && sudo systemctl restart nginx。若使用外部 Nginx，需在 /etc/gitlab/gitlab.rb 中关闭内置 Nginx：nginx[‘enable’] = false，然后 sudo gitlab-ctl reconfigure。
• 启用 HTTPS（推荐）：方案 A（内置 Let’s Encrypt）：在 /etc/gitlab/gitlab.rb 中启用 letsencrypt[‘enable’] = true、letsencrypt[‘auto_renew’] = true、letsencrypt[‘contact_emails’] = [‘admin@example.com’]，执行 sudo gitlab-ctl reconfigure；方案 B（Certbot + Nginx）：sudo apt install certbot python3-certbot-nginx；sudo certbot --nginx -d your_domain。

三 CI/CD 集成与 Runner 配置

• 安装 GitLab Runner：curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash；sudo apt install gitlab-runner。
• 注册 Runner：在 GitLab 项目或实例的 Settings → CI/CD → Runners 获取注册命令与令牌，执行 sudo gitlab-runner register，按提示填写 GitLab 实例 URL 与注册令牌，选择执行器（如 shell、docker）。
• 启动与开机自启：sudo systemctl daemon-reload；sudo systemctl start gitlab-runner；sudo systemctl enable gitlab-runner。
• 定义流水线：在项目根目录创建 .gitlab-ci.yml，示例：
  stages: [build, test, deploy]
  build_job: stage: build script: - echo “Building…” artifacts: paths: [build/]
  test_job: stage: test script: - echo “Running tests…”
  deploy_job: stage: deploy script: - echo “Deploying…” only: [master]
  提交并推送后，Runner 将自动执行构建、测试、部署。

四 邮件通知与用户管理

• SMTP 邮件配置（/etc/gitlab/gitlab.rb）：
  gitlab_rails[‘smtp_enable’] = true
  gitlab_rails[‘smtp_address’] = “smtp.example.com”
  gitlab_rails[‘smtp_port’] = 587
  gitlab_rails[‘smtp_user_name’] = “your-email@example.com”
  gitlab_rails[‘smtp_password’] = “your-password”
  gitlab_rails[‘smtp_domain’] = “example.com”
  gitlab_rails[‘smtp_authentication’] = “login”
  gitlab_rails[‘smtp_enable_starttls_auto’] = true
  gitlab_rails[‘smtp_tls’] = false
  gitlab_rails[‘gitlab_email_enabled’] = true
  gitlab_rails[‘gitlab_email_from’] = ‘gitlab@example.com’
  修改后执行 sudo gitlab-ctl reconfigure 生效。
• 用户与权限：通过 Web 界面创建项目、管理成员角色（如 Developer、Maintainer、Owner），并使用 Merge Request 进行代码审查与讨论。

五 备份恢复与运维监控

• 备份与恢复：执行 sudo gitlab-backup create 创建备份（默认位于 /var/opt/gitlab/backups）；恢复时先确保版本一致，停止相关服务，执行 sudo gitlab-backup restore BACKUP=timestamp，然后 sudo gitlab-ctl reconfigure 并启动服务。
• 日志与监控：GitLab 日志位于 /var/log/gitlab，可用于排错与审计；建议开启监控与告警（如 Prometheus 等）以观察资源与性能变化。