튜토리얼: 처음부터 GitLab Pages 웹사이트 만들기

Jekyll을 사용하여 처음부터 GitLab Pages 사이트를 만드는 단계별 튜토리얼입니다.

이 튜토리얼은 Jekyll 정적 사이트 생성기(SSG)를 사용하여 처음부터 Pages 사이트를 만드는 방법을 보여줍니다. 빈 프로젝트에서 시작하여 러너 에 지침을 제공하는 CI/CD 구성 파일을 직접 만듭니다. CI/CD 파이프라인 이 실행되면 Pages 사이트가 생성됩니다. 이 예시에서는 Jekyll을 사용하지만, 다른 SSG도 유사한 단계를 따릅니다. 이 튜토리얼을 완료하기 위해 Jekyll이나 SSG에 익숙할 필요는 없습니다. Note 일반 HTML로 Pages 사이트를 만들려면 CI/CD 템플릿에서 GitLab Pages 웹사이트 만들기 튜토리얼을 참조하세요. 사용 가능한 템플릿 목록은 프로젝트 템플릿 을 참조하세요. GitLab Pages 웹사이트를 만들려면: 1단계: 프로젝트 파일 만들기 2단계: Docker 이미지 선택 3단계: Jekyll 설치 4단계: 출력을 위한 public 디렉토리 지정 5단계: 아티팩트를 위한 public 디렉토리 지정 6단계: 웹사이트 배포 및 보기 전제 조건 # GitLab에 빈 프로젝트 가 있어야 합니다. 프로젝트 파일 만들기 # 루트(최상위) 디렉토리에 세 개의 파일을 만듭니다: .gitlab-ci.yml : 실행할 명령이 포함된 YAML 파일입니다. 지금은 파일 내용을 비워두세요. index.html : 원하는 HTML 콘텐츠로 채울 수 있는 비어있지 않은 HTML 파일입니다. 예: < html > < head > < title > Home </ title > </ head > < body > < h1 > Hello World! </ h1 > </ body > </ html > Gemfile : Ruby 프로그램의 의존성을 설명하는 파일입니다. 다음 내용으로 채우세요: source "https://rubygems.org" gem "jekyll" Docker 이미지 선택 # 이 예시에서 러너는 Docker 이미지 를 사용하여 스크립트를 실행하고 사이트를 배포합니다. 이 특정 Ruby 이미지는 DockerHub 에서 유지 관리됩니다. .gitlab-ci.yml 파일 시작 부분에 다음 CI/CD 구성을 추가하여 파이프라인에 기본 이미지를 추가합니다: default: image: ruby:3.2 SSG가 빌드하기 위해 NodeJS 가 필요한 경우, NodeJS가 파일 시스템의 일부로 포함된 이미지를 지정해야 합니다. 예를 들어, Hexo 사이트의 경우 image: node:12.17.0 을 사용할 수 있습니다. Jekyll 설치 # Jekyll 을 로컬에서 실행하려면 설치해야 합니다: 터미널을 열습니다. gem install bundler 를 실행하여 Bundler 를 설치합니다. bundle install 을 실행하여 Gemfile.lock 을 만듭니다. bundle exec jekyll build 를 실행하여 Jekyll을 설치합니다. 프로젝트에서 Jekyll을 실행하려면 .gitlab-ci.yml 파일을