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

Hover over a link to another article to get more details. If you have ideas for how we can improve this page, let us know in the discussion.

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

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

GitHub Pages는 GitHub Free 및 조직에 대한 GitHub Free가 있는 퍼블릭 리포지토리와 GitHub Pro, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server가 있는 퍼블릭 및 프라이빗 리포지토리에서 사용할 수 있습니다. 자세한 내용은 "AUTOTITLE"을 참조하세요.

Jekyll 빌드 오류 정보

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

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

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

Jekyll이 사이트 빌드를 시도하고 오류가 발생하면 빌드 오류 메시지가 표시됩니다.

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

GitHub Actions를 사용하여 Jekyll 빌드 오류 메시지 보기

기본적으로 GitHub Pages 사이트는 다른 CI 도구를 사용하도록 GitHub Pages 사이트를 구성하지 않은 한 GitHub Actions 워크플로 실행으로 빌드되고 배포됩니다. 잠재적 빌드 오류를 찾으려면 리포지토리의 워크플로 실행을 검토하여 GitHub Pages 사이트에 대한 워크플로 실행을 검사할 수 있습니다. 자세한 내용은 "워크플로 실행 기록 보기"을 참조하세요. 오류가 발생할 경우 워크플로를 다시 실행하는 방법에 대한 자세한 내용은 "워크플로 및 작업 다시 실행"을 참조하세요.

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

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

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

분기에서 게시하는 경우 GitHub Enterprise Cloud에서 게시 원본을 업데이트하기 위해 끌어오기 요청을 만들 , 끌어오기 요청의 확인 탭에서 빌드 오류 메시지를 볼 수 있습니다. 자세한 내용은 "상태 검사 정보"을 참조하세요.

사용자 지정 GitHub Actions 워크플로를 사용하여 게시하는 경우 끌어오기 요청에서 빌드 오류 메시지를 보려면 pull_request 트리거에서 실행되도록 워크플로를 구성해야 합니다. 이렇게 하면 워크플로가 pull_request 이벤트에 의해 트리거된 경우 배포 단계를 건너뛰는 것이 좋습니다. 이렇게 하면 끌어오기 요청의 변경 내용을 사이트에 배포하지 않고도 빌드 오류를 볼 수 있습니다. 자세한 내용은 "워크플로를 트리거하는 이벤트" 및 ".

메일로 Jekyll 빌드 오류 보기

분기에서 게시하는 경우 GitHub Enterprise Cloud에서 게시 원본으로 변경 내용을 푸시할 GitHub Pages에서 사이트 빌드를 시도합니다. 빌드에 실패하면 기본 메일 주소로 메일을 받게 됩니다.

사용자 지정 GitHub Actions 워크플로우를 사용하여 게시하는 경우 끌어오기 요청의 빌드 오류에 대한 메일을 받으려면 pull_request 트리거에서 실행되도록 워크플로우를 구성해야 합니다. 이렇게 하면 워크플로가 pull_request 이벤트에 의해 트리거된 경우 배포 단계를 건너뛰는 것이 좋습니다. 이렇게 하면 끌어오기 요청의 변경 내용을 사이트에 배포하지 않고도 빌드 오류를 볼 수 있습니다. 자세한 내용은 "워크플로를 트리거하는 이벤트" 및 ".

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