정적 사이트를 위한 GitLab Pages 배포 생성
Tier: Free, Premium, Ultimate
Offering: GitLab.com, 자체 관리, GitLab Dedicated
이미 정적 사이트나 프레임워크를 포함한 GitLab 프로젝트가 있다면, 해당 프로젝트로부터 GitLab Pages 웹사이트를 생성할 수 있습니다.
UI에서 기본 정보를 제공하면 .gitlab-ci.yml 파일이 생성되고
병합 요청이 열립니다. 병합 요청을 커밋하면
파이프라인이 Pages 웹사이트를 배포합니다.
전제 조건
-
앱은
public폴더에 파일을 출력해야 합니다. 빌드 파이프라인 중에 이 폴더를 생성한다면 Git에 커밋할 필요가 없습니다.이 단계가 중요합니다. 파일이 루트 수준의public폴더에 있는지 확인하세요. - 정적 사이트를 생성하거나 클라이언트 렌더링 단일 페이지 애플리케이션(SPA) (예: Eleventy, Astro, 또는 Jekyll)을 생성하는 프로젝트.
- GitLab Pages가 프로젝트에 활성화되어 있어야 합니다. (활성화하려면 설정 > 일반으로 이동하여 가시성, 프로젝트 기능, 권한을 확장하고 Pages 토글을 켭니다.)
Pages 배포 생성
설치를 완료하고 GitLab Pages 배포를 생성하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
배포 > Pages를 선택합니다.
Pages 시작하기 양식이 나타납니다. 이 양식을 사용할 수 없는 경우 문제 해결을 참조하세요.
-
1단계에서 이미지 이름을 입력하고 파일이
public폴더에 있는지 확인합니다. - 다음을 선택합니다.
-
2단계에서 설치 단계를 입력합니다. 프레임워크의 빌드 프로세스가 제공된 빌드 명령 중 어느 하나를 필요로 하지 않는 경우,
다음 중 하나를 수행할 수 있습니다:
- 다음을 선택하여 단계를 건너뛸 수 있습니다.
- 해당 단계의 기본 구조를 여전히
.gitlab-ci.yml파일에 통합하려면:(bash “아무것도 하지 않음” 명령)을 입력합니다.
- 다음을 선택합니다.
- 3단계에서 애플리케이션 빌드 방법을 나타내는 스크립트를 입력합니다.
- 다음을 선택합니다.
- 선택 사항. 생성된
.gitlab-ci.yml파일을 필요에 맞게 편집합니다. - 4단계에서 커밋 메시지를 추가하고 커밋을 선택합니다. 이 커밋으로 첫 번째 GitLab Pages 배포가 트리거됩니다.
실행 중인 파이프라인을 보려면 빌드 > 파이프라인으로 이동합니다.
배포 중에 생성된 artifact를 보려면 작업을 확인하고 오른쪽에서 artifact 다운로드를 선택합니다.
문제 해결
만약 Pages 시작하기 양식을 사용할 수 없는 경우
Pages 시작하기 양식을 사용할 수 없는 경우:
- 이전에 GitLab Pages 사이트를 배포했거나
- 적어도 한 번 양식을 통해
.gitlab-ci.yml을 커밋했을 경우.
다음과 같이 이 문제를 해결하세요:
- 메시지 Pages 파이프라인 완료 대기 중이 표시되면
양식을 다시 시작하려면 시작을 선택합니다.
- 프로젝트가 이전에 GitLab Pages를 성공적으로 배포한 경우
수동으로.gitlab-ci.yml 파일을 업데이트하세요.
도움말