GitLab은 가장 인기 있는 정적 사이트 생성기(SSG)용 샘플 프로젝트를 제공합니다. 샘플 프로젝트 중 하나를 포크하고 CI/CD 파이프라인을 실행하여 Pages 웹사이트를 생성할 수 있습니다.

GitLab Pages를 테스트하거나 Pages 사이트를 생성하도록 이미 구성된 새 프로젝트를 시작하려면 샘플 프로젝트를 포크합니다.

작동 방식은 동영상 튜토리얼에서 확인합니다.

샘플 프로젝트를 포크하고 Pages 웹사이트를 만들려면 다음과 같이 진행합니다.

1. GitLab Pages 예시 그룹으로 이동하여 샘플 프로젝트를 봅니다.
2. 포크할 프로젝트 이름을 선택합니다.
3. 오른쪽 상단 모서리에서 Fork를 선택한 다음 포크할 네임스페이스를 선택합니다.
4. 프로젝트의 왼쪽 사이드바에서 Build > Pipelines을 선택한 다음 New pipeline을 선택합니다. GitLab CI/CD가 사이트를 빌드하고 배포합니다.

사이트를 배포하는 데 약 30분이 걸릴 수 있습니다. 파이프라인이 완료되면 Deploy > Pages로 이동하여 Pages 웹사이트 링크를 찾습니다.

리포지터리에 변경 사항을 푸시할 때마다 GitLab CI/CD가 새 파이프라인을 실행하여 변경 사항을 Pages 사이트에 즉시 게시합니다.

포크 관계 제거#

포크한 원본 프로젝트에 기여하려면 포크 관계를 유지할 수 있습니다. 그렇지 않은 경우 다음과 같이 진행합니다.

1. 왼쪽 사이드바에서 Settings > General을 선택합니다.
2. Advanced settings를 펼칩니다.
3. Remove fork relationship을 선택합니다.

URL 변경#

네임스페이스와 일치하도록 URL을 변경할 수 있습니다. Pages 사이트가 GitLab.com에 호스팅되는 경우 <namespace>.gitlab.io로 이름을 바꿀 수 있습니다. 여기서 <namespace>는 GitLab 네임스페이스이며 (프로젝트를 포크할 때 선택한 네임스페이스입니다).

1. 왼쪽 사이드바에서 Settings > General을 선택합니다.

2. Advanced를 펼칩니다.

3. Change path에서 경로를 <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마다 다르며 구성 파일에 없을 수도 있습니다.

관련 주제#

• job 아티팩트 다운로드