GitLab Pages 기본 도메인 이름 및 URL
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
GitLab Pages는 네임스페이스와 프로젝트 이름을 기반으로 기본 도메인 이름을 제공합니다. 이 가이드는 GitLab Pages가 웹사이트에 도메인 이름과 URL을 할당하는 방법과 이에 맞게 정적 사이트 생성기를 구성하는 방법을 설명합니다.
GitLab Pages는 네임스페이스와 프로젝트 이름을 기반으로 기본 도메인 이름을 제공합니다. 이러한 도메인은:
- 프로젝트 사이트, 사용자 사이트, 그룹 사이트에 대한 예측 가능한 URL을 생성합니다.
- GitLab 조직 구조를 반영하는 계층적 경로를 지원합니다.
- 활성화 시 자동 리다이렉트와 함께 고유한 도메인 이름을 생성합니다.
- 커스텀 도메인 이름 및 SSL/TLS 인증서와 원활하게 작동합니다.
- 사용자, 그룹, 서브그룹 프로젝트 전반에 걸쳐 확장됩니다.
이 가이드는 GitLab Pages가 웹사이트에 도메인 이름과 URL을 할당하는 방법과 이에 맞게 정적 사이트 생성기를 구성하는 방법을 설명합니다.
GitLab Pages 기본 도메인 이름#
히스토리
- GitLab 17.4에서 고유 도메인 URL을 더 짧게 변경됨.
자체 GitLab 인스턴스를 사용하여 GitLab Pages로 사이트를 배포하는 경우, 시스템 관리자와 함께 Pages 와일드카드 도메인을 확인하세요. 이 가이드는 GitLab.com의 Pages 와일드카드 도메인(*.gitlab.io)을 자체 도메인으로 교체하면 모든 GitLab 인스턴스에 유효합니다.
GitLab에서 GitLab Pages 프로젝트를 설정하면,
namespace.example.io의 서브도메인으로 자동으로 접근할 수 있습니다.
namespace는
GitLab.com의 사용자 이름 또는
이 프로젝트를 만든 그룹 이름으로 정의됩니다.
GitLab Self-Managed의 경우 example.io를
인스턴스의 Pages 도메인으로 교체하세요. GitLab.com의 경우
Pages 도메인은 *.gitlab.io입니다.
| GitLab Pages 유형 | GitLab의 프로젝트 경로 예시 | 웹사이트 URL |
|---|---|---|
| 사용자 페이지 | username/username.example.io |
http(s)://username.example.io |
| 그룹 페이지 | acmecorp/acmecorp.example.io |
http(s)://acmecorp.example.io |
| 사용자 소유 프로젝트 페이지 | username/my-website |
http(s)://username.example.io/my-website |
| 그룹 소유 프로젝트 페이지 | acmecorp/webshop |
http(s)://acmecorp.example.io/webshop |
| 서브그룹 소유 프로젝트 페이지 | acmecorp/documentation/product-manual |
http(s)://acmecorp.example.io/documentation/product-manual |
Use unique domain 설정이 활성화되면, Pages는 플랫화된 프로젝트 이름과 6자 고유 ID로 고유한 도메인 이름을 빌드합니다. 사용자는 브라우저를 이러한 고유 도메인 URL로 리다이렉트하는 308 Permanent Redirect 상태를 받습니다. 브라우저는 이 리다이렉트를 캐시할 수 있습니다:
| GitLab Pages 유형 | GitLab의 프로젝트 경로 예시 | 웹사이트 URL |
|---|---|---|
| 사용자 페이지 | username/username.example.io |
http(s)://username-example-io-123456.example.io |
| 그룹 페이지 | acmecorp/acmecorp.example.io |
http(s)://acmecorp-example-io-123456.example.io |
| 사용자 소유 프로젝트 페이지 | username/my-website |
https://my-website-123456.gitlab.io/ |
| 그룹 소유 프로젝트 페이지 | acmecorp/webshop |
http(s)://webshop-123456.example.io/ |
| 서브그룹 소유 프로젝트 페이지 | acmecorp/documentation/product-manual |
http(s)://product-manual-123456.example.io/ |
예시 URL의 123456은 6자 고유 ID입니다.
예를 들어, 고유 ID가 f85695이면 마지막 예시는
http(s)://product-manual-f85695.example.io/입니다.
일반 도메인 이름 및 HTTPS에서 제공되는 네임스페이스와 관련된 제한 사항은 서브도메인의 서브도메인을 참조하세요.
Pages 도메인을 명확히 이해하려면 아래 예시를 읽어보세요.
다음 예시는 Use unique domain 설정을 비활성화했다고 가정합니다. 비활성화하지 않은 경우 이전 표를 참조하여 example.io를 gitlab.io로 교체하세요.
프로젝트 웹사이트 예시#
- 사용자 이름
john아래에blog라는 프로젝트를 만들었으므로 프로젝트 URL은https://gitlab.com/john/blog/입니다. 이 프로젝트에 GitLab Pages를 활성화하고 사이트를 빌드하면https://john.gitlab.io/blog/에서 접근할 수 있습니다. - 모든 웹사이트를 위한
websites라는 그룹을 만들고 이 그룹의 프로젝트를blog라고 했습니다. 프로젝트 URL은https://gitlab.com/websites/blog/입니다. 이 프로젝트에 GitLab Pages를 활성화하면 사이트는https://websites.gitlab.io/blog/에서 사용할 수 있습니다. - 엔지니어링 부서를 위해
engineering이라는 그룹과 모든 문서 웹사이트를 위한docs라는 서브그룹을 만들었으며 이 서브그룹의 프로젝트를workflows라고 했습니다. 프로젝트 URL은https://gitlab.com/engineering/docs/workflows/입니다. 이 프로젝트에 GitLab Pages를 활성화하면 사이트는https://engineering.gitlab.io/docs/workflows에서 사용할 수 있습니다.
사용자 및 그룹 웹사이트 예시#
- 사용자 이름
john아래에john.gitlab.io라는 프로젝트를 만들었습니다. 프로젝트 URL은https://gitlab.com/john/john.gitlab.io입니다. 프로젝트에 GitLab Pages를 활성화하면 웹사이트는https://john.gitlab.io에 게시됩니다. - 그룹
websites아래에websites.gitlab.io라는 프로젝트를 만들었습니다. 프로젝트 URL은https://gitlab.com/websites/websites.gitlab.io입니다. 프로젝트에 GitLab Pages를 활성화하면 웹사이트는https://websites.gitlab.io에 게시됩니다.
일반 예시:
- GitLab.com에서 프로젝트 사이트는 항상
https://namespace.gitlab.io/project-slug에서 사용할 수 있습니다. - GitLab.com에서 사용자 또는 그룹 웹사이트는
https://namespace.gitlab.io/에서 사용할 수 있습니다. - GitLab 인스턴스에서는
gitlab.io를 Pages 서버 도메인으로 교체하세요. 이 정보는 시스템 관리자에게 문의하세요.
URL 및 기본 URL#
baseurl 옵션은 일부 정적 사이트 생성기에서 다르게 이름 지정될 수 있습니다.
모든 정적 사이트 생성기(SSG) 기본 구성은 도메인의 서브디렉토리(example.com/subdir)가 아닌 (서브)도메인(example.com) 아래에서 웹사이트를 찾을 것으로 예상합니다. 따라서 프로젝트 웹사이트(예: namespace.gitlab.io/project-slug)를 게시할 때마다 정적 사이트 생성기 문서에서 이 구성(기본 URL)을 찾아 이 패턴을 반영하도록 설정해야 합니다.
예를 들어, Jekyll 사이트의 경우 baseurl은 Jekyll 구성 파일인 _config.yml에서 정의됩니다. 웹사이트 URL이 https://john.gitlab.io/blog/이면 _config.yml에 다음 줄을 추가해야 합니다:
baseurl: "/blog"
기본 예시 중 하나를 포크하여 웹사이트를 배포하는 경우 baseurl은 이미 이 방식으로 구성되어 있습니다. 모든 예시는 프로젝트 웹사이트입니다. 사용자 또는 그룹 웹사이트로 만들기로 결정한 경우 프로젝트에서 이 구성을 제거해야 합니다. Jekyll 예시의 경우 Jekyll _config.yml을 다음과 같이 변경합니다:
baseurl: ""
일반 HTML 예시를 사용하는 경우 baseurl을 설정할 필요가 없습니다.
커스텀 도메인#
GitLab Pages는 HTTP 또는 HTTPS로 제공되는 커스텀 도메인 및 서브도메인을 지원합니다. 자세한 내용은 GitLab Pages 커스텀 도메인 및 SSL/TLS 인증서를 참조하세요.