Skip to main content

Эта версия GitHub Enterprise Server была прекращена 2024-07-09. Исправления выпускаться не будут даже при критических проблемах безопасности. Для повышения производительности, повышения безопасности и новых функций выполните обновление до последней версии GitHub Enterprise Server. Чтобы получить справку по обновлению, обратитесь в службу поддержки GitHub Enterprise.

Сведения об ошибках сборки Jekyll для сайтов GitHub Pages

Если Jekyll обнаруживает ошибку при создании сайта GitHub Pages локально или на GitHub Enterprise Server, вы получите сообщение об ошибке, содержащее дополнительные сведения.

Кто может использовать эту функцию?

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 может обнаружить причину сбоя, появится описательное сообщение об ошибке.

Дополнительные сведения об устранении ошибок сборки см. в разделе "Устранение ошибок сборки Jekyll для сайтов GitHub Pages".

Просмотр сбоев сборки репозитория в GitHub Enterprise Server

Вы можете просматривать сбои сборки (но не предупреждения сборки) для сайта в GitHub Enterprise Server на вкладке Параметры репозитория сайта.

Просмотр сообщений об ошибках сборки Jekyll локально

Рекомендуется тестировать сайт локально, так как это позволяет просматривать сообщения об ошибках сборки в командной строке и устранять все сбои сборки перед отправкой изменений в GitHub Enterprise Server. Дополнительные сведения см. в разделе Локальное тестирование сайта GitHub Pages с помощью Jekyll.

Просмотр сообщений об ошибках сборки Jekyll в запросе на вытягивание

При публикации из ветви при создании запроса на вытягивание для обновления источника публикации на GitHub Enterprise Serverможно увидеть сообщения об ошибках сборки на вкладке "Проверки " запроса на вытягивание. Дополнительные сведения см. в разделе Сведения о проверках состояния.

Если вы публикуете настраиваемый рабочий процесс GitHub Actions для просмотра сообщений об ошибках сборки в запросе на вытягивание, необходимо настроить рабочий процесс для запуска триггера pull_request . В таком случае рекомендуется пропустить все шаги развертывания, если рабочий процесс был активирован событием pull_request. Это позволит просматривать ошибки сборки без развертывания на сайте изменений из запроса на вытягивание. Дополнительные сведения см. в разделе "[AUTOTITLE" и "События, инициирующие рабочие процессы](/actions/learn-github-actions/expressions)".

Просмотр ошибок сборки Jekyll по электронной почте

При публикации из ветви при отправке изменений в источник публикации на GitHub Enterprise Server, GitHub Pages попытается создать сайт. Если сборка завершится неудачно, вы получите сообщение по основному адресу электронной почты.

Вы получите только сообщение электронной почты, если поддержка исходящей почты включена в ваш экземпляр GitHub Enterprise Server. Для получения дополнительных сведений обратитесь к администратору сайта.

Если вы публикуете настраиваемый рабочий процесс GitHub Actions для получения сообщений электронной почты об ошибках сборки в запросе на вытягивание, необходимо настроить рабочий процесс для запуска на триггере pull_request . В таком случае рекомендуется пропустить все шаги развертывания, если рабочий процесс был активирован событием pull_request. Это позволит просматривать ошибки сборки без развертывания на сайте изменений из запроса на вытягивание. Дополнительные сведения см. в разделе "[AUTOTITLE" и "События, инициирующие рабочие процессы](/actions/learn-github-actions/expressions)".

Просмотр сообщений об ошибках сборки Jekyll в запросе на вытягивание с помощью сторонней службы CI

Вы можете настроить стороннюю службу, такую как 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. Возможно, потребуется активировать репозиторий со сторонней службой тестирования. Дополнительные сведения см. в документации по вашей службе тестирования.