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

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

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

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

В этой статье

Примечание.

Хотя драгоценный github-pages камень остается поддерживаемым для некоторых рабочих процессов, GitHub Actions теперь является рекомендуемым подходом для развертывания и автоматизации сайтов GitHub Pages.

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

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

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

Примечание.

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

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

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

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

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

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

Мы рекомендуем протестировать сайт локально, что позволяет просматривать сообщения об ошибках сборки в командной строке и устранять все ошибки сборки перед отправкой изменений GitHub. Дополнительные сведения см. в разделе Тестирование сайта GitHub Pages локально с помощью Jekyll.

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

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

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

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

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

Если вы публикуете настраиваемый GitHub Actions рабочий процесс, чтобы получать сообщения электронной почты об ошибках сборки в запросе на вытягивание, необходимо настроить рабочий процесс для запуска на триггере pull_request . В таком случае рекомендуется пропустить все шаги развертывания, если рабочий процесс был активирован событием pull_request. Это позволит просматривать ошибки сборки без развертывания на сайте изменений из запроса на вытягивание. Дополнительные сведения см. в разделе [AUTOTITLE и События, инициирующие рабочие процессы](/actions/reference/workflows-and-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. Возможно, потребуется активировать репозиторий со сторонней службой тестирования. Дополнительные сведения см. в документации по вашей службе тестирования.