정적 사이트를 위한 GitLab 페이지 배포 생성

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

이미 GitLab 프로젝트에 정적 사이트 또는 프레임워크가 포함되어 있다면, 해당 프로젝트에서 GitLab Pages 웹사이트를 생성할 수 있습니다.

UI에서 기본 정보를 제공하면 .gitlab-ci.yml 파일이 생성되고 Merge Request이 열립니다. Merge Request을 커밋하면 파이프라인이 페이지 웹사이트를 배포합니다.

전제 조건

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

    caution
    이 단계는 중요합니다. 파일이 루트 레벨의 public 폴더에 있는지 확인하세요.
  • 다음 중 하나가 포함된 프로젝트여야 합니다:
    • 정적 사이트나 클라이언트 렌더링 단일 페이지 애플리케이션(SPA)을 생성하는 프로젝트, Eleventy, Astro, 또는 Jekyll와 같은 것
    • 정적 출력을 구성한 프레임워크가 있는 프로젝트, Next.js, Nuxt, 또는 SvelteKit과 같은 것
  • 프로젝트에서 GitLab Pages가 활성화되어 있어야 합니다. (활성화하려면 Settings > General로 이동하여 Visibility, project features, permissions을 확장하고 Pages 토글을 켭니다.)

Pages 배포 생성

설정을 완료하고 GitLab Pages 배포를 생성하려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 배포 > Pages를 선택합니다.

    GitLab Pages 시작하기 양식이 나타납니다. 양식이 없는 경우 문제 해결을 참조하세요.

  3. 단계 1에서 이미지 이름을 입력하고 파일이 public 폴더에 있는지 확인합니다.
  4. 다음을 선택합니다.
  5. 단계 2에서 설치 단계를 입력합니다. 프레임워크의 빌드 프로세스가 제공된 빌드 명령 중 하나가 필요하지 않은 경우, 다음 중 하나를 수행할 수 있습니다:
    • 다음을 선택하여 단계를 건너 뜁니다.
    • 해당 단계의 기본 서식을 여전히 .gitlab-ci.yml 파일에 통합하려면 : (bash “아무것도 안 하기” 명령)를 입력합니다.
  6. 다음을 선택합니다.
  7. 단계 3에서 애플리케이션 빌드 방법을 나타내는 스크립트를 입력합니다.
  8. 다음을 선택합니다.
  9. 선택 사항. 필요한 경우 생성된 .gitlab-ci.yml 파일을 수정합니다.
  10. 단계 4에서 커밋 메시지를 추가하고 커밋을 선택합니다. 이 커밋으로 첫 번째 GitLab Pages 배포가 트리거됩니다.

실행 중인 파이프라인을 보려면 빌드 > 파이프라인으로 이동합니다.

배포 중에 생성된 artifacts를 보려면 작업을 보고 오른쪽에서 artifacts 다운로드를 선택합니다.

문제 해결

해당 양식을 사용할 수 없는 경우

GitLab Pages 시작하기 양식이 사용할 수 없는 경우:

  • 이전에 GitLab Pages 사이트를 배포했습니다.
  • 최소한 한번은 양식을 통해 .gitlab-ci.yml을 커밋했습니다.

이 문제를 해결하려면:

  • Pages 파이프라인이 완료될 때까지 대기 중입니다라는 메시지가 나타나면 양식을 다시 시작하려면 다시 시작을 선택합니다.
  • 프로젝트가 이전에 GitLab Pages를 성공적으로 배포했으면, (.gitlab-ci.yml) 파일을 매뉴얼으로 업데이트합니다.