GitLab Pages 기본 도메인 이름과 URL

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

이 문서에서는 GitLab Pages를 위한 프로젝트 명칭을 설정하여 의도한 웹사이트 URL에 따라 학습합니다.

GitLab Pages 기본 도메인 이름

만약 GitLab Pages로 사이트를 배포하기 위해 사용자의 GitLab 인스턴스를 이용한다면, 페이지 와일드카드 도메인을 시스템 관리자에게 인증받으세요. 이 안내서는 *.gitlab.io의 Pages 와일드카드 도메인을 본인의 도메인으로 대체한다면, 어떠한 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

고유 도메인 사용 설정이 활성화된 경우, 모든 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인 경우, 마지막 예시의 URL은 다음과 같습니다. http(s)://product-manual-documentation-acmecorp-30bae2547a50der6ed7d9a08d417a33525a5c4dc6fdd68.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) 아래에서 찾을 것을 기대합니다. 그 도메인의 하위 디렉토리가 아닌데도 (example.com/subdir) 따라서, 예를 들어 프로젝트 웹사이트를 공개할 때 (예: 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 인증서을 참조하세요.