GitLab Pages 기본 도메인 이름 및 URL

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

이 문서에서는 GitLab Pages용 프로젝트의 이름을 원하는 웹사이트 URL에 따라 지정하는 방법을 알아봅니다.

GitLab Pages 기본 도메인 이름

GitLab Pages를 사용하여 사이트를 배포하려면 자체 GitLab 인스턴스를 사용하는 경우 시스템 관리자에게 Pages 와일드카드 도메인을 확인하세요.이 가이드는 GitLab 인스턴스에 대한 모든 GitLab에 대해 유효하며, GitLab.com (*.gitlab.io)의 페이지 와일드카드 도메인을 사용하여 교체한 경우에도 해당됩니다.

GitLab Pages 프로젝트를 GitLab에서 설정하면 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

고유 도메인 사용 설정이 활성화되어 있는 경우 모든 URL은 다음 구조로 펼쳐집니다.

GitLab Pages의 유형 GitLab에서 프로젝트의 예제 경로 웹사이트 URL
사용자 페이지 username/username.example.io http(s)://username-example-io-username.example.io
그룹 페이지 acmecorp/acmecorp.example.io http(s)://acmecorp-example-io-acmecorp-uniqueid.example.io
사용자가 소유한 프로젝트 페이지 username/my-website https://my-website-username-uniqueid.gitlab.io/
그룹이 소유한 프로젝트 페이지 acmecorp/webshop http(s)://webshop-acmecorp-uniqueid.example.io/
서브그룹이 소유한 프로젝트 페이지 acmecorp/documentation/product-manual http(s)://product-manual-documentation-acmecorp-uniqueid.example.io/

URL의 unique_id 부분은 영숫자 문자열입니다. 예를 들어, unique_id가 30bae2547a50der6ed7d9a08d417a33525a5c4dc6fdd68인 경우, 마지막 예제는 다음과 같을 것입니다. http(s)://product-manual-documentation-acmecorp-30bae2547a50der6ed7d9a08d417a33525a5c4dc6fdd68.example.io/.

caution
일반 도메인 및 HTTPS 하위 도메인으로 제공되는 네임스페이스에 대한 알려진 제한 사항이 있습니다. 해당 섹션을 반드시 읽으십시오.

Pages 도메인을 명확하게 이해하기 위해 아래 예제를 읽으십시오.

note
아래 예제는 고유 도메인 사용 설정이 해제되었다는 것을 가정합니다. 그렇지 않은 경우, 이전 테이블에서 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를 해당 페이지 서버 도메인으로 교체하십시오. 이 정보는 시스템 관리자에게 문의하세요.

URL 및 기본 URL

note
baseurl 옵션은 일부 정적 사이트 생성기 (SSG)의 기본 설정이름이 다를 수 있습니다.

모든 정적 사이트 생성기 (SSG)의 기본 설정은 도메인 (example.com)아래의 (하위) 경로에 웹사이트가 있는 것으로 예상합니다. 따라서 프로젝트 웹사이트를 게시할 때마다 (예: namespace.gitlab.io/project-slug), 해당 구성 (기본 URL)을 정적 사이트 생성기의 설명서에서 찾아 이 패턴을 반영하도록 설정해야 합니다.

예를 들어 Jekyll 사이트의 경우, baseurl은 Jekyll 구성 파일인 _config.yml에 정의됩니다. 여러분의 웹사이트 URL이 https://john.gitlab.io/blog/인 경우, 다음 라인을 _config.yml에 추가해야 합니다. 

baseurl: "/blog"

반대로, 기본 예제 중 하나를 fork한 후 웹사이트를 배포하는 경우, baseurl은 이미 이렇게 구성되어 있습니다. 모든 예제는 프로젝트 웹사이트이기 때문입니다. 여러분이 사용자 또는 그룹 웹사이트로 만든다고 결정하면, 프로젝트에서 이 구성을 삭제해야 합니다. 방금 언급한 Jekyll 예제의 경우, Jekyll의 _config.yml를 다음과 같이 변경해야 합니다. 

baseurl: ""

일반 HTML 예제를 사용하는 경우 baseurl을 설정할 필요가 없습니다.

사용자 정의 도메인

GitLab Pages는 HTTP 또는 HTTPS로 제공되는 사용자 정의 도메인 및 하위 도메인을 지원합니다. 자세한 정보는 GitLab Pages 사용자 정의 도메인 및 SSL/TLS 인증서을 참조하십시오.