GitLab은 가장 많이 쓰이는 정적 사이트 생성기(SSG)용 .gitlab-ci.yml 템플릿을 제공합니다. 이러한 템플릿 중 하나에서 직접 .gitlab-ci.yml 파일을 만들고 CI/CD 파이프라인을 실행하여 Pages 웹사이트를 생성할 수 있습니다.

Pages 사이트를 추가하려는 기존 프로젝트가 있을 때 .gitlab-ci.yml 템플릿을 사용합니다.

GitLab 리포지터리에는 SSG 전용 파일이나 일반 HTML 이 들어 있어야 합니다. 아래 단계를 완료한 뒤에도 Pages 사이트가 제대로 생성되도록 추가 구성이 필요할 수 있습니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. Add (+) 드롭다운 목록에서 New file을 선택합니다.
3. Filename 텍스트 상자에 .gitlab-ci.yml을 입력합니다. 텍스트 상자 오른쪽에 드롭다운 목록이 나타납니다.
4. Apply a template 드롭다운 목록의 Pages 섹션에서 사용하는 SSG 이름을 선택합니다. 일반 HTML 이라면 HTML을 선택합니다.
5. Commit message 텍스트 상자에 커밋 메시지를 입력합니다.
6. Commit changes를 선택합니다.

모든 구성이 올바르면 사이트 배포에 약 30분이 걸릴 수 있습니다.

파이프라인을 보려면 Build > Pipelines로 이동합니다.

파이프라인이 끝나면 Deploy > Pages로 이동하여 Pages 웹사이트 링크를 확인합니다.

리포지터리에 푸시되는 모든 변경 사항에 대해 GitLab CI/CD가 새 파이프라인을 실행하여 변경 사항을 Pages 사이트에 즉시 게시합니다.

사이트용으로 생성된 HTML과 그 밖의 자산을 보려면 job 아티팩트를 다운로드합니다.