GitLab Pages 관리 트러블슈팅

GitLab Pages 관리 시 발생하는 일반적인 문제 해결 방법을 설명합니다. 로그 확인, 502/404/500 오류, OAuth 인증 오류, DNS 설정 문제 등을 다룹니다.

GitLab Pages를 관리할 때 다음 문제가 발생할 수 있습니다. GitLab Pages 로그 보기 # 다음 명령을 실행하여 Pages 데몬 로그를 볼 수 있습니다: sudo gitlab-ctl tail gitlab-pages 로그 파일은 /var/log/gitlab/gitlab-pages/current 에서도 찾을 수 있습니다. 자세한 내용은 로그에서 correlation ID 가져오기 를 참조하세요. GitLab Pages 디버그 # 다음 시퀀스 다이어그램은 GitLab Pages 요청이 처리되는 방법을 보여줍니다. GitLab Pages 사이트가 배포되고 오브젝트 스토리지에서 정적 콘텐츠를 제공하는 방법에 대한 자세한 내용은 GitLab Pages 아키텍처 설명서를 참조하세요. Mermaid 다이어그램 (36줄) 소스 코드 보기 %%{init: { "fontFamily": "GitLab Sans" }}%% sequenceDiagram accTitle: GitLab Pages Request Flow accDescr: Sequence diagram showing how a user request flows through GitLab Pages components to serve static files. actor User participant PagesNGINX as Pages NGINX participant Pages as GitLab Pages participant GitlabNGINX as GitLab NGINX participant GitlabAPI as GitLab Rails participant ObjectStorage as Object Storage User->>PagesNGINX: Request to Pages activate PagesNGINX PagesNGINX->>Pages: Forwarded to Pages activate Pages Pages->>GitlabNGINX: Fetch domain info activate GitlabNGINX GitlabNGINX->>GitlabAPI: Forwarded to GitLab API activate GitlabAPI GitlabAPI->>GitlabNGINX: 200 OK (domain info) deactivate GitlabAPI GitlabNGINX->>Pages: 200 OK (domain info) deactivate GitlabNGINX Note right of Pages: Domain information cached in Pages Pages->>ObjectStorage: Fetch static files activate ObjectStorage ObjectStorage->>Pages: 200 OK (files) deactivat