GitLab Pages 기본 도메인 이름 및 URL
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_id
가 30bae2547a50der6ed7d9a08d417a33525a5c4dc6fdd68
인 경우,
마지막 예시는 http(s)://product-manual-documentation-acmecorp-30bae2547a50der6ed7d9a08d417a33525a5c4dc6fdd68.example.io/
가 됩니다.
해당 섹션을 반드시 읽으십시오.
Pages 도메인을 명확히 이해하려면 아래 예시들을 읽어보세요.
만약 그렇지 않다면,
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 서버 도메인으로 대체하세요.
이 정보는 sysadmin에게 문의하세요.
URL과 기본 URL
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 인증서을 참조하세요.