Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

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

Jekyll이 로컬로 또는 GitHub Enterprise Server에서 GitHub Pages 사이트를 빌드하는 동안 오류가 발생하면 자세한 정보가 포함된 에러 메시지를 받게 됩니다.

GitHub Pages는 GitHub Free 및 조직에 대한 GitHub Free가 있는 퍼블릭 리포지토리와 GitHub Pro, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server가 있는 퍼블릭 및 프라이빗 리포지토리에서 사용할 수 있습니다.

Jekyll 빌드 오류 정보

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

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

참고: GitHub Enterprise Server에 변경 내용을 푸시한 후 사이트 변경 내용이 게시되려면 최대 10분이 걸릴 수 있습니다.

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

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

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

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

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

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

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

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

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

메일로 Jekyll 빌드 오류 보기

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

your GitHub Enterprise Server instance에서 아웃바운드 전자 메일 지원을 사용하도록 설정한 경우에만 이메일을 받게 됩니다. 자세한 내용은 사이트 관리자에게 문의하세요.

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