인프라

gitlab 설치후 계속 502 발생할때

소행성왕자 2025. 4. 9. 08:57

GitLab 설치 후 502 Bad Gateway 오류가 계속 발생할 경우, 다음 항목들을 순차적으로 확인해보시는 것이 좋습니다.

대부분은 GitLab의 구성 요소(gitlab-workhorse, unicorn/puma, nginx 등) 중 하나가 제대로 작동하지 않아서 발생합니다.

1. GitLab 서비스 상태 확인

sudo gitlab-ctl status

 

  • 모든 서비스가 run: ... 상태인지 확인하세요.
  • run:이 아니고 down:이라면 해당 서비스에 문제가 있는 것입니다.

2. 로그확인

 

sudo gitlab-ctl tail​

로그를 확인한후 충돌되는 포트 있는지 확인한다.

# 포트 확인
sudo ss -tuln

# 특정포트 확인
sudo ss -tuln | grep :8080

3.Puma (또는 Unicorn) 오류 확인 및 재시작

sudo gitlab-ctl restart puma

4. gitlab.rb 설정 오류 확인

sudo gitlab-ctl reconfigure