GitLab Pages 기본 도메인 이름 및 URL

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

이 문서에서는 GitLab Pages를 사용하여 프로젝트의 이름을 지어
의도한 웹사이트의 URL에 따라 방법을 배우세요.

GitLab Pages 기본 도메인 이름

만약 GitLab Pages로 사이트를 배포하기 위해 자체 GitLab 인스턴스를 사용한다면,
sysadmin과 함께 Pages 와일드카드 도메인을 확인하세요. 이 가이드는 어떤 GitLab 인스턴스에서든 유효하지만,
GitLab.com의 Pages 와일드카드 도메인 (*.gitlab.io)을 자체 도메인으로 대체해야 합니다.

만약 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의 고유_id 부분은 알파벳과 숫자의 조합입니다. 예를 들어, unique_id30bae2547a50der6ed7d9a08d417a33525a5c4dc6fdd68인 경우,
마지막 예시는 http(s)://product-manual-documentation-acmecorp-30bae2547a50der6ed7d9a08d417a33525a5c4dc6fdd68.example.io/가 됩니다.

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

Pages 도메인을 명확히 이해하려면 아래 예시들을 읽어보세요.

note
다음 예시들은 고유 도메인 사용 설정을 비활성화했다고 가정합니다.
만약 그렇지 않다면, example.iogitlab.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 서버 도메인으로 대체하세요.
    이 정보는 sysadmin에게 문의하세요.

URL과 기본 URL

note
baseurl 옵션은 일부 정적 사이트 생성기(Site Generator)에서 이름이 다를 수 있습니다.

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

예를 들어, Jekyll 사이트의 경우, baseurl은 Jekyll 설정 파일인 _config.yml에 정의됩니다.
만약 당신의 웹사이트 URL이 https://john.gitlab.io/blog/라면,
_config.yml에 다음 라인을 추가해야 합니다:

baseurl: "/blog"

반대로, GitLab의 기본 예시 중 하나를 복제한 후 웹사이트를 배포하는 경우,
모든 예시는 프로젝트 웹사이트로 설정되어 있기 때문에 baseurl이 이미 이와 같이 구성되어 있습니다.
만약 본인의 것을 사용자 또는 그룹 웹사이트로 만들기로 결정한다면,
해당 구성을 프로젝트에서 제거해야 합니다. 앞서 언급한 Jekyll 예시에서는 Jekyll의 _config.yml을 다음과 같이 변경해야 합니다:

baseurl: ""

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

사용자 지정 도메인

GitLab Pages는 HTTP 또는 HTTPS 하에서 서비스되는 사용자 지정 도메인 및 서브도메인을 지원합니다.
더 많은 정보는 GitLab Pages 사용자 지정 도메인 및 SSL/TLS 인증서을 참조하세요.