GitLab项目中的Puma服务器配置与优化指南

GitLab项目中的Puma服务器配置与优化指南

gitlabhq GitLab CE Mirror | Please open new issues in our issue tracker on GitLab.com 项目地址: https://gitcode.com/gh_mirrors/gi/gitlabhq

前言

Puma作为GitLab项目默认集成的Ruby应用服务器，在高并发场景下表现出色。本文将深入探讨如何优化GitLab中的Puma配置，解决常见问题，并分享性能调优经验。

Puma基础架构

Puma采用主从架构模式，主进程负责管理多个工作进程。每个工作进程启动时会与主进程共享内存，采用写时复制(CoW)机制，仅在内存页被修改时才分配新内存。这种设计使得Puma在内存使用上非常高效。

内存管理优化

内存限制配置

默认情况下，GitLab设置Puma工作进程的内存限制为1200MB。当工作进程内存超过此阈值时，监控线程会自动重启该进程。

配置方法：

1. 编辑/etc/gitlab/gitlab.rb文件：

   puma['per_worker_max_memory_mb'] = 1024 # 设置为1GB
   

2. 重新配置GitLab：

   sudo gitlab-ctl reconfigure
   

监控内存重启事件

内存超限重启事件会记录在日志文件中，典型日志格式如下：

{
  "severity": "WARN",
  "time": "2023-01-04T09:45:16.173Z",
  "pid": 2725,
  "worker_id": "puma_0",
  "memwd_rss_bytes": 1077682176,
  "memwd_max_rss_bytes": 629145600,
  "message": "rss memory limit exceeded"
}

关键指标说明：

• memwd_rss_bytes: 实际内存使用量
• memwd_max_rss_bytes: 配置的内存限制值

超时设置调整

默认情况下，Puma请求超时时间为60秒。如需调整为600秒：

1. 编辑/etc/gitlab/gitlab.rb：

   gitlab_rails['env'] = {
      'GITLAB_RAILS_RACK_TIMEOUT' => 600
    }
   

2. 重新配置GitLab

内存受限环境优化

在内存小于4GB的环境中，可以考虑禁用Puma集群模式：

1. 编辑/etc/gitlab/gitlab.rb：

   puma['worker_processes'] = 0
   

2. 重新配置GitLab

注意事项：

• 单进程模式下不支持phased restart功能
• 内存监控功能将失效
• 吞吐量会有所下降

SSL配置指南

配置Puma监听HTTPS端口：

1. 生成SSL证书
2. 编辑/etc/gitlab/gitlab.rb：

   puma['ssl_listen'] = '127.0.0.1'
   puma['ssl_port'] = 9111
   puma['ssl_certificate'] = '<证书路径>'
   puma['ssl_certificate_key'] = '<密钥路径>'
   puma['socket'] = "" # 禁用UNIX socket
   

3. 重新配置GitLab

加密SSL密钥配置

1. 加密密钥：

   openssl rsa -aes256 -in ssl-key.pem -out encrypted-ssl-key.pem
   

2. 创建密码脚本
3. 配置GitLab：

   puma['ssl_certificate_key'] = '/path/to/encrypted-ssl-key.pem'
   puma['ssl_key_password_command'] = '/path/to/password-script'
   

从Unicorn迁移到Puma

迁移步骤：

1. 确定合适的Puma工作进程和线程数
2. 将Unicorn配置转换为Puma配置
3. 重新配置GitLab

配置项对照表：

| Unicorn配置项 | Puma对应配置项 | |---------------|----------------| | unicorn['worker_processes'] | puma['worker_processes'] | | unicorn['worker_memory_limit_max'] | puma['per_worker_max_memory_mb'] |

常见问题排查

502网关超时问题

当Puma进程CPU占用100%时可能出现此问题。排查方法：

1. 使用gdb附加到Puma进程：

   sudo gdb -p <PID>
   

2. 在gdb中执行：

   call (void) rb_backtrace()
   

3. 检查/var/log/gitlab/puma/puma_stderr.log中的堆栈跟踪

API不可访问问题

可能原因包括：

• 数据库连接超时
• Git钩子执行错误
• 仓库访问问题

排查方法：

strace -ttTfyyy -s 1024 -p <PID> -o /tmp/puma.txt

最佳实践建议

1. 生产环境建议至少4GB内存
2. 监控Puma工作进程重启频率
3. 根据实际负载调整线程数和工作进程数
4. 定期检查日志中的内存警告信息
5. 在高负载环境中考虑增加超时时间

通过合理配置Puma参数，可以显著提升GitLab的性能和稳定性。建议根据实际环境进行测试和调优，找到最适合的配置方案。

gitlabhq GitLab CE Mirror | Please open new issues in our issue tracker on GitLab.com 项目地址: https://gitcode.com/gh_mirrors/gi/gitlabhq