GitLab Pages 배포 생성하기

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

이미 정적 사이트 또는 프레임워크가 포함된 GitLab 프로젝트가 있다면,
그로부터 GitLab Pages 웹사이트를 생성할 수 있습니다.

UI에 기본 정보를 제공하면 .gitlab-ci.yml 파일이 생성되고
머지 요청이 열립니다. 머지 요청을 커밋하면,
파이프라인이 당신의 Pages 웹사이트를 배포합니다.

전제 조건

  • 앱은 public 폴더에 파일을 출력해야 합니다.
    빌드 파이프라인 중에 이 폴더를 생성하면, Git에 커밋할 필요는 없습니다.

    경고:
    이 단계는 중요합니다. 파일이 루트 레벨의 public 폴더에 있는지 확인하세요.

  • 정적 사이트를 생성하거나 다음과 같은 클라이언트 렌더링 단일 페이지 애플리케이션(SPA)을 보유한 프로젝트여야 합니다:
  • GitLab Pages는 프로젝트에 대해 활성화되어 있어야 합니다. (활성화하려면, Settings > General로 가서,
    Visibility, project features, permissions를 확장하고 Pages 토글을 켭니다.)

Pages 배포 생성하기

설정을 완료하고 GitLab Pages 배포를 생성하려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

  2. Deploy > Pages를 선택합니다.

    Get Started with Pages 양식이 나타납니다. 이 양식이 사용 불가능한 경우,
    문제 해결을 참조하세요.

  3. Step 1에서 이미지 이름을 입력하고 파일이 public 폴더에 있는지 확인합니다.

  4. Next를 선택합니다.

  5. Step 2에서 설치 단계를 입력합니다. 프레임워크의 빌드 프로세스에 제공된 빌드 명령이 필요하지 않다면,
    다음 중 하나를 선택할 수 있습니다:
    • Next를 선택하여 단계를 생략합니다.
    • 해당 단계의 보일러플레이트를 .gitlab-ci.yml 파일에 포함하려면
      : (bash “아무것도 하지 않기” 명령)를 입력합니다.

  6. Next를 선택합니다.

  7. Step 3에서 애플리케이션을 빌드하는 방법을 나타내는 스크립트를 입력합니다.

  8. Next를 선택합니다.

  9. 선택 사항입니다. 필요에 따라 생성된 .gitlab-ci.yml 파일을 편집합니다.

  10. Step 4에서 커밋 메시지를 추가하고 Commit을 선택합니다. 이 커밋은 첫 번째
    GitLab Pages 배포를 트리거합니다.

실행 중인 파이프라인을 보려면 Build > Pipelines로 가세요.

배포 중 생성된 아티팩트를 보려면 작업을 보고, 오른쪽에서 Download artifacts를 선택하세요.

문제 해결

Get Started with Pages 양식이 사용 불가능한 경우

Get Started with Pages 양식은 다음과 같은 경우에 사용 불가능합니다:

  • 이전에 GitLab Pages 사이트를 배포한 경우.
  • 양식을 통해 .gitlab-ci.yml을 최소 한 번 커밋한 경우.

이 문제를 해결하려면:

  • Waiting for the Pages Pipeline to complete 메시지가 나타나는 경우,
    Start over를 선택하여 양식을 다시 시작합니다.
  • 프로젝트가 이전에 GitLab Pages를 성공적으로 배포했었다면,
    .gitlab-ci.yml 파일을 수동으로 업데이트 하세요.