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.

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

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

GitHub Pages доступен в общедоступных репозиториях при использовании GitHub Free и GitHub Free для организаций, а также в общедоступных и частных репозиториях при использовании GitHub Pro, GitHub Team, GitHub Enterprise Cloud и GitHub Enterprise Server. Дополнительные сведения см. в разделе Продукты GitHub.

Сведения об ошибках сборки Jekyll

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

  • Пользователь, отправивший изменения, не проверил свой адрес электронной почты. Дополнительные сведения см. в разделе Подтверждение адреса электронной почты.
  • Вы выполняете отправку с помощью ключа развертывания. Если вы хотите автоматизировать отправки в репозиторий сайта, можно вместо этого настроить пользователя компьютера. Дополнительные сведения см. в разделе Управление ключами развертывания.
  • Вы используете службу CI, которая не настроена для сборки источника публикации. Например, Travis CI не будет создавать ветвь gh-pages, если вы не добавите эту ветвь в список безопасных объектов. Дополнительные сведения см. в разделе Настройка сборки в документации Travis CI или вашей службы CI.

Примечание. Публикация изменений на сайте после передачи изменений в GitHub Enterprise Cloud может занять до 10 минут.

Если Jekyll при попытке сборки сайта обнаружит ошибку, вы получите сообщение об ошибке сборки.

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

Просмотр сообщений об ошибках сборки Jekyll с помощью GitHub Actions

По умолчанию ваш сайт GitHub Pages создается и развертывается с помощью рабочего процесса GitHub Actions, если только вы не настроили сайт GitHub Pages для использования другого средства CI. Чтобы найти потенциальные ошибки сборки, можно проверить выполнение рабочего процесса для сайта GitHub Pages, просмотрев выполнение рабочего процесса репозитория. Дополнительные сведения см. в разделе Просмотр истории выполнения рабочего процесса. Дополнительные сведения о повторном запуске рабочего процесса в случае ошибки см. в разделе Повторный запуск рабочих процессов и заданий.

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

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

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

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

Если публикация выполняется с помощью пользовательского рабочего процесса GitHub Actions, для просмотра сообщений об ошибках сборки в запросе на вытягивание необходимо настроить запуск рабочего процесса по триггеру pull_request. В таком случае рекомендуется пропустить все шаги развертывания, если рабочий процесс был активирован событием pull_request. Это позволит просматривать ошибки сборки без развертывания на сайте изменений из запроса на вытягивание. Дополнительные сведения см. в разделах События, инициирующие рабочие процессы и Выражения.

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

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

Если публикация выполняется с помощью пользовательского рабочего процесса GitHub Actions, для получения сообщений электронной почты об ошибках сборки в запросе на вытягивание необходимо настроить запуск рабочего процесса по триггеру pull_request. В таком случае рекомендуется пропустить все шаги развертывания, если рабочий процесс был активирован событием pull_request. Это позволит просматривать ошибки сборки без развертывания на сайте изменений из запроса на вытягивание. Дополнительные сведения см. в разделах События, инициирующие рабочие процессы и Выражения.

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