정적 사이트를 위한 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. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 배포 > Pages를 선택합니다.

    Pages 시작하기 양식이 표시됩니다. 이 양식이 사용할 수 없는 경우 문제 해결을 참조하세요.

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

실행 중인 파이프라인을 보려면 빌드 > 파이프라인으로 이동하세요.

배포 중에 생성된 artifact를 보려면 작업을 보고 오른쪽에서 artifact 다운로드를 선택하세요.

문제 해결

시작하기 페이지 양식을 사용할 수 없는 경우

시작하기 페이지 양식은 다음의 경우 사용할 수 없습니다: - 이전에 GitLab Pages 사이트를 배포했습니다. - 최소한 한 번 이상 양식을 통해 .gitlab-ci.yml을 커밋했습니다.

이 문제를 해결하려면: - Pages 파이프라인이 완료될 때까지 대기 메시지가 표시되면, 양식을 다시 시작하려면 다시 시작을 선택하세요. - 프로젝트가 이전에 GitLab Pages를 성공적으로 배포한 경우, .gitlab-ci.yml 파일을 수동으로 업데이트하세요(수동 업데이트).