Ubuntu 上定位与解决 GitLab 性能瓶颈
一 快速定位瓶颈
- 资源与进程：用 top/htop、iotop、nethogs 观察 CPU、内存、磁盘 I/O、网络 是否打满；GitLab 默认会启动较多组件，资源紧张时容易卡顿。
- 组件健康：执行 gitlab-ctl status 检查 puma、sidekiq、gitaly、postgresql、redis、nginx 是否异常重启或报错。
- 日志与监控：查看 /var/log/gitlab 下各组件日志；如已启用，用内置 Prometheus + Grafana 观察请求耗时、排队、错误率与数据库指标。
- 仓库与作业：近期是否大量 CI/CD 任务、Webhook、LFS 大文件 或仓库对象激增；这些都会放大后端压力。
以上做法能快速判断是计算、I/O、数据库还是后台任务成为主要瓶颈，从而决定优化方向。
二 硬件与存储优化
- 使用 SSD/NVMe 替代 HDD，优先保证数据库与仓库数据的高 IOPS 与低延迟。
- 合理规划内存：GitLab 为内存密集型，建议至少 4 核 CPU、8 GB 内存 起步；小规格实例可适当使用 Swap 缓解 OOM（注意仅作为兜底，不能替代扩容）。
- 对象存储：将 LFS、上传附件、备份 等放到对象存储（如 S3/MinIO），减轻本地磁盘与数据库压力。
- 网络：对外访问可接入 CDN 加速静态资源；内网传输尽量使用 内网带宽 与稳定链路。
这些改动通常能立竿见影地改善页面响应、克隆与流水线执行速度。
三 GitLab 配置优化
- 精简监控组件（测试/小型实例适用）：关闭不需要的监控与导出器以释放内存与 CPU。示例（/etc/gitlab/gitlab.rb）：
monitoring_role[‘enable’] = false
prometheus[‘enable’] = false
alertmanager[‘enable’] = false
postgres_exporter[‘enable’] = false
redis_exporter[‘enable’] = false
node_exporter[‘enable’] = false
修改后执行：gitlab-ctl reconfigure。注意 puma、sidekiq、gitaly、redis、postgresql、nginx 为核心组件，勿随意关闭。
- Web 与后台并发（按实例规格调小，避免资源争用）：
puma[‘worker_processes’] = 2
puma[‘min_threads’] = 1
puma[‘max_threads’] = 2
sidekiq[‘concurrency’] = 4
- 数据库（PostgreSQL）基础参数（中小实例保守设置）：
postgresql[‘shared_buffers’] = “128MB”
postgresql[‘work_mem’] = “4MB”
如实例规格提升，可再按监控与负载逐步上调。
- 仓库维护：定期执行 git gc 清理冗余对象，减少仓库体积与 I/O。
- 大文件管理：使用 Git LFS 管理二进制/大文件，避免污染 Git 对象库。
- 版本与清理：保持 GitLab 版本更新；定期清理无用数据、日志与旧流水线产物。
上述配置能显著降低小规格实例的资源占用，并减少高并发下的排队与超时。
四 网络与内核参数优化
- 调整 TCP 与连接参数（/etc/sysctl.conf 或 sysctl -w 临时生效）：
net.ipv4.tcp_tw_reuse = 1
net.ipv4.tcp_fin_timeout = 30
net.core.somaxconn = 65535
net.ipv4.ip_local_port_range = “1024 65535”
net.ipv4.tcp_fastopen = 3
- Nginx 层：启用 HTTP/2 与 Keep-Alive，减少连接开销、提升并发：
nginx[‘enable’] = true
nginx[‘listen_port’] = 80
nginx[‘listen_https’] = false
nginx[‘ssl_certificate_file’] = “/etc/gitlab/ssl/gitlab.example.com.crt”
nginx[‘ssl_certificate_key_file’] = “/etc/gitlab/ssl/gitlab.example.com.key”
nginx[‘ssl_protocols’] = “TLSv1.2 TLSv1.3”
nginx[‘keepalive_timeout’] = 65
这些网络与内核优化有助于缓解高并发下的连接瓶颈与握手开销。
五 CI/CD 与扩展架构
- Runner 与构建：为 GitLab Runner 配置合理的并发与标签，使用 分布式 Runner 与缓存（如 cache/artifacts 到 SSD 或对象存储），避免构建挤占 Web/数据库资源。
- 扩展方式：用户与流水线增长后，采用 多实例 + 负载均衡（HAProxy/Nginx） 与数据库高可用，分摊前端与后台压力。
- 监控告警：完善 Prometheus/Grafana 仪表盘与阈值告警，持续观察队列、延迟与错误趋势，提前干预。
通过构建侧解耦与水平扩展，可稳定支撑研发规模增长。
