GitLab Pages 웹사이트 생성하기

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

GitLab은 가장 인기 있는 정적 사이트 생성기(Static Site Generators, SSG)에 대한 샘플 프로젝트를 제공합니다. 여러분은 샘플 프로젝트 중 하나를 fork하고 CI/CD 파이프라인을 실행하여 Pages 웹사이트를 생성할 수 있습니다.

Pages 웹사이트를 생성하려면 샘플 프로젝트를 fork하여 GitLab Pages를 테스트하거나 이미 Pages 사이트를 생성할 수 있도록 구성된 새 프로젝트를 시작할 때 사용합니다.

비디오 튜토리얼을 시청하세요.

샘플 프로젝트를 fork하고 Pages 웹사이트를 생성하려면:

  1. GitLab Pages 예제 그룹으로 이동하여 샘플 프로젝트를 확인합니다.
  2. fork하고 싶은 프로젝트 이름을 선택합니다.
  3. 오른쪽 상단에서 Fork를 선택한 후 fork할 네임스페이스를 선택합니다.
  4. 프로젝트를 위해 왼쪽 사이드바에서 Build > Pipelines를 선택하고 Run pipeline을 선택합니다. GitLab CI/CD가 사이트를 빌드하고 배포합니다.

사이트의 배포에는 약 30분 정도 소요될 수 있습니다. 파이프라인이 완료되면 Deploy > Pages로 이동하여 Pages 웹사이트의 링크를 찾을 수 있습니다.

리포지터리로 푸시하는 모든 변경 사항에 대해 GitLab CI/CD는 Pages 사이트로 즉시 게시되는 새로운 파이프라인을 실행합니다.

fork 관계 제거

fork한 프로젝트에 기여하고 싶은 경우 fork 관계를 유지할 수 있습니다. 그렇지 않은 경우:

  1. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  2. 고급 설정을 확장합니다.
  3. fork 관계 제거를 선택합니다.

URL 변경

URL을 네임스페이스에 맞게 변경할 수 있습니다. GitLab.com에서 Pages 사이트를 호스팅하는 경우 <namespace>.gitlab.io로 이름을 변경할 수 있습니다. 여기서 <namespace>은 fork할 때 선택한 GitLab 네임스페이스입니다.

  1. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  2. Advanced를 확장합니다.

  3. 경로 변경에서 경로를 <namespace>.gitlab.io로 업데이트합니다.

    예를 들어, 프로젝트의 URL이 gitlab.com/gitlab-tests/jekyll이고, 네임스페이스가 gitlab-tests인 경우, 리포지터리 경로를 gitlab-tests.gitlab.io로 설정하면 Pages 웹사이트의 결과 URL은 https://gitlab-tests.gitlab.io가 됩니다.

    리포지터리 경로 변경

  4. SSG 구성 파일을 열고 기본 URL을 "project-name"에서 ""로 변경합니다. 프로젝트 이름 설정은 SSG별로 다르며 구성 파일에 없을 수도 있습니다.

관련 주제