GitHub Pages 사이트에 대한 Jekyll 빌드 오류 정보

Jekyll 빌드 오류 정보

경우에 따라 사이트 게시 원본으로 변경 내용을 푸시한 후 GitHub Pages이(가) 사이트를 빌드하려고 시도하지 않는 경우가 있습니다.

• 배포 키를 사용하여 푸시하고 있습니다. 사이트의 리포지토리에 대한 푸시를 자동화하려는 경우 컴퓨터 사용자를 대신 설정할 수 있습니다. 자세한 내용은 "배포 키 관리"을 참조하세요.
• 게시 원본을 빌드하도록 구성되지 않은 CI 서비스를 사용하고 있습니다. 예를 들어 Travis CI는 안전한 목록에 gh-pages 분기를 추가하지 않는 한 분기를 빌드하지 않습니다. 자세한 내용은 Travis CI의 “빌드 사용자 지정” 또는 CI 서비스의 설명서를 참조하세요.

Jekyll이 사이트 빌드를 시도하고 오류가 발생하면 빌드 오류 메시지가 표시됩니다. Jekyll 빌드 오류 메시지는 두 가지 주요 유형이 있습니다.

• “페이지 빌드 경고” 메시지는 빌드가 성공적으로 완료되었음을 의미하지만 향후 문제를 방지하기 위해 변경 작업을 수행해야 할 수 있습니다.
• “페이지 빌드 실패” 메시지는 빌드를 완료하지 못했음을 의미합니다. Jekyll이 실패 이유를 검색할 수 있는 경우 이를 설명하는 오류 메시지가 표시됩니다.

빌드 오류 문제 해결에 대한 자세한 내용은 "GitHub 페이지 사이트에 대한 Jekyll 빌드 오류 문제 해결"을 참조하세요.

GitHub Enterprise Server에서 리포지토리의 빌드 실패 보기

사이트 리포지토리의 설정 탭에서 GitHub Enterprise Server의 사이트에 대한 빌드 실패(빌드 경고는 아님)를 볼 수 있습니다.

Jekyll 빌드 오류 메시지 로컬 보기

GitHub Enterprise Server에 변경 내용을 푸시하기 전에 명령줄에서 빌드 오류 메시지를 확인하고 빌드 실패를 해결할 수 있도록 사이트를 로컬로 테스트하는 것이 좋습니다. 자세한 내용은 "Jekyll을 사용하여 로컬로 GitHub Pages 사이트 테스트"을 참조하세요.

끌어오기 요청에서 Jekyll 빌드 오류 메시지 보기

때, 끌어오기 요청의 확인 탭에서 빌드 오류 메시지를 볼 수 있습니다. 자세한 내용은 "상태 검사 정보"을 참조하세요.

메일로 Jekyll 빌드 오류 보기

때 GitHub Pages에서 사이트 빌드를 시도합니다. 빌드에 실패하면 기본 메일 주소로 메일을 받게 됩니다.

타사 CI 서비스를 사용하여 끌어오기 요청에서 Jekyll 빌드 오류 메시지 보기

Travis CI와 같은 타사 서비스를 구성하여 각 커밋 후에 오류 메시지를 표시할 수 있습니다.

1. 아직 수행하지 않은 경우 다음 콘텐츠와 함께 게시 원본의 루트에 Gemfile이라는 파일을 추가합니다.

   source `https://rubygems.org`
   gem `github-pages`
   

2. 선택한 테스트 서비스에 대한 사이트의 리포지토리를 구성합니다. 예를 들어 Travis CI를 사용하려면 게시 원본의 루트에 .travis.yml이라는 파일을 다음 콘텐츠와 함께 추가합니다.

   language: ruby
   rvm:
     - 2.3
   script: "bundle exec jekyll build"
   

3. 타사 테스트 서비스를 사용하여 리포지토리를 활성화해야 할 수 있습니다. 자세한 내용은 테스트 서비스의 설명서를 참조하세요.