소스 컴파일 설치를 위한 GitLab Pages 관리

소스 컴파일 방식으로 설치된 GitLab에서 Pages 데몬 설치, 와일드카드 도메인·커스텀 도메인·TLS 설정, 접근 제어, 스토리지 경로 변경, 최대 크기 및 보안 설정 방법을 설명합니다.

- Tier: Free, Premium, Ultimate - Offering: GitLab Self-Managed GitLab Pages를 활성화하기 전에 먼저 GitLab 설치 를 성공적으로 완료했는지 확인하세요. 이 문서는 소스 컴파일 방식으로 설치된 GitLab에서 GitLab Pages를 구성하는 방법을 설명합니다. Linux 패키지 설치(권장)에서 GitLab Pages를 구성하는 방법에 대한 자세한 내용은 Linux 패키지 문서 를 참조하세요. Linux 패키지 설치에는 최신 지원 버전의 GitLab Pages가 포함되어 있습니다. GitLab Pages 작동 원리 # GitLab Pages는 GitLab Pages 데몬을 사용합니다. 이는 외부 IP 주소에서 수신 대기하며 커스텀 도메인 및 인증서를 지원하는 경량 HTTP 서버입니다. SNI 를 통한 동적 인증서를 지원하며 기본적으로 HTTP2를 사용하여 페이지를 제공합니다. 자세한 내용은 README 를 참조하세요. 커스텀 도메인 의 경우, Pages 데몬은 80 또는 443 포트에서 수신 대기해야 합니다. 이는 와일드카드 도메인 에는 적용되지 않습니다. 다음 방법 중 하나로 설정할 수 있습니다: GitLab과 동일한 서버에서, 보조 IP를 사용하여 수신 대기. 별도의 서버에서. Pages 경로 도 해당 서버에 있어야 하므로 네트워크를 통해 공유해야 합니다. GitLab과 동일한 서버에서, 동일한 IP이지만 다른 포트를 사용하여 수신 대기. 이 경우 로드 밸런서로 트래픽을 프록시해야 합니다. HTTPS의 경우 TCP 로드 밸런싱을 사용하세요. TLS 종료(HTTPS 로드 밸런싱)를 사용하면 사용자가 제공한 인증서로 페이지를 제공할 수 없습니다. HTTP의 경우 HTTP 또는 TCP 로드 밸런싱 모두 허용됩니다. 다음 섹션에서는 첫 번째 옵션을 기준으로 설명합니다. 커스텀 도메인을 지원하지 않는 경우 보조 IP는 필요하지 않습니다. 사전 요구 사항 # Pages 구성을 진행하기 전에 다음을 확인하세요: GitLab Pages를 제공할 별도의 도메인이 있어야 합니다. 이 문서에서 이 도메인은 example.io 입니다. 해당 도메인에 대한 와일드카드 DNS 레코드 를 구성해야 합니다. GitLab이 설치된 동일한 서버에 zip 및 unzip 패키지가 설치되어 있어야 합니다. 이 패키지는 Pages 아티팩트를 압축 및 압축 해제하는 데 필요합니다. 선택 사항. HTTPS로 Pages를 제공하려면 Pages 도메인( *.example.io )에 대한 와일드카드 인증서 가 있어야 합니다. 선택 사항이지만 권장. 사용자가 직접 구성할 필요가 없도록 인스턴스 러너 를 구성하고 활성화하세요. DNS 구성 # GitLab Pages는 자체 가상 호스트에서 실행되어야 합니다. DNS 서버 또는 공급업체에서 GitLab이 실행 중인 호스트를 가리키는 와일드카드 DNS A 레코드 를 추가하세요. 예를 들면: <span class="line"><span class="cl">*.e