CentOS环境下GitLab的故障排查技巧 - 问答

CentOS环境下GitLab故障排查技巧

1. 检查GitLab服务状态

使用gitlab-ctl status命令查看所有GitLab相关服务（如unicorn、sidekiq、postgresql、redis等）的运行状态。若服务未运行或显示异常（如“down”），可通过gitlab-ctl restart重启服务，或针对单个服务（如gitlab-ctl restart unicorn）重启特定组件。

2. 查看GitLab日志定位问题

GitLab日志集中存储在/var/log/gitlab/目录下，涵盖rails应用、nginx、postgresql等组件的日志。常用查看方式：

实时查看所有日志：sudo gitlab-ctl tail；
查看特定服务日志（如nginx访问日志）：sudo gitlab-ctl tail nginx/gitlab_access.log；
使用命令行工具过滤关键信息（如错误、警告）：sudo grep -E 'ERROR|WARN' /var/log/gitlab/gitlab-rails/production.log（统计错误数量可加| wc -l）。

3. 验证依赖服务运行状态

GitLab依赖PostgreSQL（数据库）、Redis（缓存）、Nginx（Web服务）等组件，需逐一检查其状态：

sudo gitlab-ctl status postgresql（查看数据库状态）；
sudo gitlab-ctl status redis（查看缓存状态）；
sudo systemctl status nginx（查看web服务状态，若未使用GitLab自带的nginx则需检查系统nginx）。
若依赖服务未运行，需启动对应服务（如sudo gitlab-ctl start postgresql）。

4. 检查网络与端口配置

GitLab默认使用80（HTTP）、443（HTTPS）、22（SSH）等端口，需确保：

端口未被其他应用占用（如sudo netstat -ntlp | grep 80查看80端口占用进程，若有则kill -9 <PID>终止）；

防火墙开放必要端口（CentOS 7及以上使用firewall-cmd）：

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --permanent --add-service=ssh
sudo firewall-cmd --reload

5. 校验配置文件正确性

GitLab主配置文件为/etc/gitlab/gitlab.rb，需重点检查：

external_url配置（需与服务器IP/域名一致，如external_url 'http://192.168.1.100'）；
数据库连接参数（如gitlab_rails['db_host']、gitlab_rails['db_password']）；
代理设置（若使用代理需确保http_proxy/https_proxy配置正确）。
修改配置后，需执行sudo gitlab-ctl reconfigure使配置生效，再重启服务（sudo gitlab-ctl restart）。

6. 排查资源不足问题

内存不足：GitLab对内存要求较高，若服务器内存不足（如小于4GB），可通过增加交换分区（swap）缓解：

sudo dd if=/dev/zero of=/data/swap bs=512 count=8388616  # 创建4GB交换文件
sudo mkswap /data/swap                                # 格式化交换文件
sudo swapon /data/swap                                # 启用交换分区

磁盘空间不足：使用df -h查看磁盘使用情况，若/var/opt/gitlab（GitLab数据目录）或/var/log/gitlab（日志目录）空间不足，需清理旧日志（如sudo rm -rf /var/log/gitlab/*.log.*）或归档数据。

7. 分析系统日志辅助排查

使用journalctl查看GitLab相关系统日志，获取更全面的系统级错误信息：

实时查看GitLab服务日志：sudo journalctl -u gitlab-rails -f；
查看特定时间段日志（如最近1小时）：sudo journalctl -u gitlab-rails --since "1 hour ago"；
查看服务启动日志：sudo journalctl -u gitlab-rails -b（-b表示当前启动周期）。

8. 常见问题针对性解决

502 Bad Gateway：通常因unicorn或sidekiq服务崩溃，需重启对应服务（sudo gitlab-ctl restart unicorn sidekiq）；
403 Forbidden：可能因权限问题（如/var/opt/gitlab目录属主错误），需修复权限（sudo chown -R git:git /var/opt/gitlab）；
RPC failed; result 22：因Git对象过大（如提交文件超过100MB），需修改GitLab配置（/etc/gitlab/gitlab.rb中添加gitlab_rails['git_max_size'] = 1024 * 1024 * 1024，即1GB），并调整nginx的client_max_body_size（如设置为1024M），修改后重启服务。

0 赞

0 踩