如何在CentOS上定制GitLab功能

在 CentOS 上定制 GitLab 功能

一 基础准备与安装

• 更新系统并安装依赖：sudo yum update -y && sudo yum install -y curl policycoreutils-python-utils openssh-server perl
• 添加 GitLab 官方仓库并安装（以社区版为例）：curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
• 安装 GitLab：sudo yum install -y gitlab-ce
• 修改配置文件：sudo vi /etc/gitlab/gitlab.rb（例如设置 external_url）
• 使配置生效：sudo gitlab-ctl reconfigure
• 启动服务：sudo gitlab-ctl start
• 防火墙放行 HTTP/HTTPS：sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --permanent --add-service=https && sudo firewall-cmd --reload
• 首次访问按提示设置管理员密码

二 常用功能定制

• 界面与语言
  • 修改访问地址：在 /etc/gitlab/gitlab.rb 中设置 external_url ‘http://your-domain-or-ip’ 后执行 sudo gitlab-ctl reconfigure
  • 语言切换：用户登录后，头像 → Preferences → Localization 选择简体中文并保存
• 邮件通知（SMTP）
  • 安装邮件服务：sudo yum install -y postfix
  • 在 /etc/gitlab/gitlab.rb 中启用并配置 SMTP（示例为端口 465/TLS）
    • gitlab_rails[‘smtp_enable’] = true
    • gitlab_rails[‘smtp_address’] = “smtp.exmail.qq.com”
    • gitlab_rails[‘smtp_port’] = 465
    • gitlab_rails[‘smtp_user_name’] = “your_email@example.com”
    • gitlab_rails[‘smtp_password’] = “your_password”
    • gitlab_rails[‘smtp_authentication’] = “login”
    • gitlab_rails[‘smtp_enable_starttls_auto’] = false
    • gitlab_rails[‘smtp_tls’] = true
    • gitlab_rails[‘gitlab_email_from’] = ‘your_email@example.com’
    • gitlab_rails[‘smtp_domain’] = “example.com”
  • 使配置生效：sudo gitlab-ctl reconfigure
• 外部认证（LDAP/OmniAuth）
  • 在 /etc/gitlab/gitlab.rb 中按需配置 LDAP 或 OmniAuth（如企业常用的 LDAP 统一登录），保存后执行 sudo gitlab-ctl reconfigure
• 端口与访问
  • 如需修改默认端口，编辑 /etc/gitlab/gitlab.rb 中的 external_url 及 nginx 监听端口，然后 sudo gitlab-ctl reconfigure
• 存储与备份策略
  • 大附件/备份可对接对象存储（如 Amazon S3/MinIO）
  • 备份与恢复：gitlab-rake gitlab:backup:create 与 gitlab-rake gitlab:backup:restore

三 集成与扩展

• Webhooks 与 API
  • 项目 Settings → Webhooks 配置目标 URL 与触发事件，实现与第三方系统的事件联动
  • 通过 Personal Access Token 调用 GitLab API（v4），例如：curl --header “Private-Token: ” https://your-gitlab/api/v4/projects
• 服务端钩子与服务
  • 使用项目级 Webhooks 或 Services 与外部系统对接，实现代码推送、合并请求等事件的自动化处理

四 运维与安全加固

• 性能与高可用
  • 建议资源：至少4 核 CPU/4GB 内存（推荐8 核/8GB+），磁盘50GB+（SSD 更佳）
  • 并发与缓存：调整连接池、超时；启用 Redis 缓存
  • 扩展：多实例部署，前置 HAProxy/Nginx 做负载均衡
• 监控与日志
  • 使用 Prometheus/Grafana 监控资源与错误
  • 定期清理过期日志，保留关键审计信息
• 升级与维护
  • 及时升级至稳定版本，保留回滚方案
  • 定期测试备份恢复流程，确保可用性

五 故障排查与常见问题

• 502 Bad Gateway
  • 常见为端口冲突（如 8080 被占用）。编辑 /etc/gitlab/gitlab.rb 调整 unicorn 或 nginx 监听端口，执行 sudo gitlab-ctl reconfigure
• 配置未生效
  • 修改 /etc/gitlab/gitlab.rb 后务必执行 sudo gitlab-ctl reconfigure；必要时 sudo gitlab-ctl restart
• 邮件发送失败
  • 核对 SMTP 参数（端口、TLS/SSL、用户名/密码、发件人域），确保与邮件服务商要求一致，然后重载配置