ubuntu gitlab 故障排查步骤是什么

Ubuntu 上 GitLab 故障排查步骤

一 快速判断与恢复

• 查看整体状态与组件健康：执行 sudo gitlab-ctl status，关注是否出现 down 或 fail，以及关键组件（如 nginx、postgresql、redis、puma/unicorn、sidekiq、gitaly）的状态。
• 前台实时看日志定位错误：执行 sudo gitlab-ctl tail（或指定组件如 sudo gitlab-ctl tail nginx），优先从报错组件入手。
• 配置变更或异常后尝试重建运行环境：执行 sudo gitlab-ctl reconfigure，随后重启相关服务。
• 重启单个或全部组件：如 sudo gitlab-ctl restart nginx；必要时 sudo gitlab-ctl restart。
• 若使用 Docker 部署：进入容器排查，如 docker exec -it <容器名> gitlab-ctl status，必要时 docker exec -it <容器名> gitlab-ctl restart；容器异常时用 docker logs <容器名> 查看容器日志。

二 常见症状与对应处理

三 深入排查命令清单

• 服务状态与重启
  • 查看：sudo gitlab-ctl status
  • 重启：sudo gitlab-ctl restart （如 nginx、postgresql、redis、puma/unicorn、sidekiq）
• 日志定位
  • 全部实时日志：sudo gitlab-ctl tail
  • 指定组件：sudo gitlab-ctl tail nginx
  • 组件日志文件：/var/log/gitlab/<组件>/（如 /var/log/gitlab/gitlab-rails/production.log）
  • 系统日志：sudo journalctl -u gitlab-runsvdir -f
• 端口与连通性
  • 检查占用：sudo netstat -tulpen | grep -E ‘80|443|22’
  • 本机访问测试：curl -I http://127.0.0.1
• 资源与权限
  • 资源：free -m、df -h、dmesg | tail
  • 权限：确保 /var/opt/gitlab、/var/log/gitlab 属主为 git:git
• 配置与重建
  • 重新生成配置：sudo gitlab-ctl reconfigure
• Docker 场景
  • 容器状态与日志：docker ps -a、docker logs <容器名>
  • 进入容器运维：docker exec -it <容器名> bash，在容器内执行 gitlab-ctl 系列命令

四 高频问题与修复要点

• 大量组件报 fail: runsv not running

  • 执行 sudo systemctl restart gitlab-runsvdir
  • 检查 systemctl -t target 与 systemctl list-jobs，若发现 plymouth-quit-wait.service 处于 running 并阻塞其他任务，先执行 sudo systemctl stop plymouth-quit-wait.service，再启动 GitLab（如 gitlab-ctl start）。

• 访问 502 Bad Gateway

  • 常见为 puma/unicorn 未就绪或 nginx 无法连接上游；重启 puma/unicorn 与 nginx，并查看 /var/log/gitlab/nginx/gitlab_error.log 与 /var/log/gitlab/puma/current 的错误细节。

• 断电/异常关机后启动异常

  • 先确保磁盘可写且空间充足，再重启 gitlab-runsvdir 与各组件；必要时执行 gitlab-ctl reconfigure 重建运行环境。

• 端口冲突或防火墙阻断

  • 检查 80/443/22 是否被占用（如被其他 Web 服务占用需调整或停用）；在宿主机放行防火墙（如 sudo ufw allow ‘Nginx Full’）与云安全组规则，确保浏览器可直连 http://服务器IP/。

• 配置变更后异常

  • 任何对 /etc/gitlab/gitlab.rb 的修改，执行 sudo gitlab-ctl reconfigure 使配置生效，再按需重启相关组件。