Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

GitLab 페이지 웹 사이트 만들기

CI/CD 템플릿을 사용하여 페이지 웹 사이트 만들기

페이지 사이트를 추가할 기존 프로젝트가 있는 경우 .gitlab-ci.yml 템플릿 사용

해당 GitLab 리포지토리는 SSG(정적 사이트 생성기-Static Site Generators) 또는 일반 HTML에 해당하는 파일을 포함해야 하며, 이 단계를 완료한 후 페이지 사이트가 올바르게 생성되도록 추가 구성을 수행해야 할 수 있다.

  1. 왼쪽 사이드바 > Project overview 클릭

  2. Set up CI/CD 클릭


    이 버튼이 없는 경우, CI/CD가 프로젝트에 대해 이미 구성되어 있는 것이다. 리포지토리에서 .gitlab-ci.yml 파일을 찾아 수정한다.

  3. Apply a template 목록에서 사용 중인 SSG에 대한 템플릿을 선택. 평범한 HTML 선택 가능


    사용중인 템플릿을 찾을 수 없으면 GitLab Pages 그룹 샘플 프로젝트를 볼 수 있다. 이러한 프로젝트에는 필요에 따라 수정할 수 있는 .gitlab-ci.yml 파일이 포함되어 있다. 또한 GitLab 페이지용 .gitlab-ci.yml 파일을 직접 작성하는 방법도 배울 수 있다.

  4. .gitlab-ci.yml 파일을 저장하고 커밋

모든 것이 올바르게 구성되면, 이 사이트를 구축하는 데 약 30분 정도 소요 된다.

CI / CD > Pipelines 에서 파이프라인이 돌아가는 것을 볼 수 있으며, 파이프라인이 완료되면 Settings > Pages로 이동하여 페이지 웹 사이트에 대한 링크를 찾을 수 있다.

새 프로젝트 템플릿에서 페이지 웹 사이트 만들기

GitLab Pages를 테스트하거나 이미 Pages 사이트를 생성하도록 구성된 새 프로젝트를 시작하려는 경우 프로젝트 템플릿을 사용

  1. 상단 내비게이션 바에서 + 버튼 > New project 선택

  2. Create from Template 선택

  3. Pages 로 시작하는 템플릿 중 하나 선택 > Use template 클릭

  4. 양식을 작성한 후 Create project 클릭

  5. 왼쪽 사이드바 > CI/CD > Pipelines > Run pipeline 클릭하여 GitLab CI/CD를 트리거하여 사이트를 구축하고 배포

이 사이트를 구축하는 데 약 30분이 걸릴 수 있다. 파이프라인이 완료되면, Settings > Pages로 이동하여 페이지 웹 사이트에 대한 링크를 찾을 수 있다.

포크한 샘플에서 페이지 웹 사이트 만들기

GitLab은 가장 인기 있는 정적 사이트 생성기를 위한 샘플 프로젝트를 제공한다. 샘플 프로젝트 중 하나를 포크하고 CI/CD 파이프라인을 실행하여 페이지 웹 사이트를 생성할 수 있다.

  1. GitLab 페이지 예제 그룹으로 이동하여 샘플 프로젝트를 확인

  2. 포크를 적용할 프로젝트 이름 클릭

  3. 우측 상단 Fork 버튼 클릭하여 포크로 이동할 네임스페이스 선택

  4. 왼쪽 사이드바 > CI/CD > Pipelines > Run pipeline 클릭하여 GitLab CI/CD를 트리거하여 사이트를 구축하고 배포

이 사이트를 구축하는 데 약 30분이 걸릴 수 있다. 파이프라인이 완료되면, Settings > Pages로 이동하여 페이지 웹 사이트에 대한 링크를 찾을 수 있다.

리포지토리에 푸시되는 모든 변경에 대해 GitLab CI/CD는 변경사항을 페이지 사이트에 즉시 게시하는 새 파이프라인을 실행한다.

몇 가지 추가 단계를 수행할 수 있다.

  • 포크 관계를 제거하라. 당신이 포크했던 프로젝트에 기여하고 싶다면, 이 관계를 유지할 수 있다. 그렇지 않으면 프로젝트의 Settings > General로 이동하고 Advanced settings를 확장한 다음 아래로 스크롤하여 Remove fork relationship 선택한다.

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

    • 프로젝트의 Settings > General로 이동하여 Advanced settings를 확장한다. 아래로 스크롤하여 Change path로 이동하고 경로를 <namespace>.gitlab.io로 변경한다.
      예를 들어, 프로젝트의 URL이 gitlab.com/gitlab-tests/jekyll 이고 네임스페이스는 gitlab-tests일 경우, 리포지토리 경로를 gitlab-tests.gitlab.io으로 설정하면 페이지 웹 사이트의 URL은 https://gitlab-tests.gitlab.io로 나타난다.

    • 이제 SSG의 구성 파일로 이동하여 기본 URL을 "프로젝트 이름"에서 ""로 변경한다. 프로젝트 이름 설정은 SSG에 따라 다르며 구성 파일에 없을 수 있다.

  • No labels