Настройка источника публикации для вашего сайта GitHub Pages

Сведения об источниках публикаций

Сайт можно публиковать при отправке изменений в определенную ветвь, а также с помощью рабочего процесса GitHub Actions.

Если вам не нужно управлять сборкой сайта, рекомендуется публиковать сайт, когда изменения отправляются в определенную ветвь. Можно указать, какую ветвь и папку следует использовать в качестве источника публикации. Исходной ветвью может стать любая ветвь репозитория, а исходной папкой может быть либо корень репозитория (/), либо папка /docs в исходной ветви. После отправки изменений в исходную ветвь изменения в исходной папке будут опубликованы на вашем сайте GitHub Pages.

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

Публикация из ветви

1. Убедитесь, что в вашем репозитории уже содержится ветвь, которую необходимо использовать в качестве источника публикации.

2. На сайте GitHubперейдите в репозиторий сайта.

3. Под именем репозитория щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

4. В разделе "Код и автоматизация" боковой панели щелкните Pages.

5. В разделе "Сборка и развертывание" в пункте "Источник" выберите Развернуть из ветви.

6. В разделе "Сборка и развертывание" используйте раскрывающееся меню ветви и выберите источник публикации.

1. При необходимости используйте раскрывающееся меню папки, чтобы выбрать папку для источника публикации.

1. Нажмите кнопку Сохранить.

Устранение неполадок при публикации из ветви

Если вы выберете папку docs в любой ветви в качестве источника публикации, а затем удалите папку /docs из этой ветви в репозитории, сайт не будет собран и вы получите сообщение об ошибке сборки страницы для отсутствующей папки /docs. Дополнительные сведения см. в разделе Устранение ошибок сборки Jekyll для сайтов GitHub Pages.

Ваш GitHub Pages сайт всегда будет развернут с GitHub Actions помощью запуска рабочего процесса, даже если вы настроили свой GitHub Pages сайт с помощью другого средства CI. Большинство внешних рабочих процессов CI развертываются путем GitHub Pages фиксации выходных данных сборки в gh-pages ветви репозитория и обычно включают .nojekyll файл. В этом случае GitHub Actions рабочий процесс обнаружит состояние, которое ветвь не нуждается в шаге сборки, и выполнит только шаги, необходимые для развертывания сайта на GitHub Pages серверах.

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

Публикация с помощью пользовательского GitHub Actions рабочего процесса

Настройка сайта для публикации с помощью GitHub Actions:

1. На сайте GitHubперейдите в репозиторий сайта.

2. Под именем репозитория щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

3. В разделе "Код и автоматизация" боковой панели щелкните Pages.

4. В разделе "Сборка и развертывание" в разделе "Источник" выберите GitHub Actions.

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

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

Создание пользовательского GitHub Actions рабочего процесса для публикации сайта

Дополнительные сведения см. в GitHub Actionsразделе GitHub Actions Документация.

При настройке сайта для публикации GitHub ActionsGitHub будет предлагать шаблоны рабочих процессов для распространенных сценариев публикации. Обычно рабочий процесс состоит из следующих действий:

1. Активируйте каждый раз, когда выполняется отправка в ветвь по умолчанию репозитория или каждый раз, когда рабочий процесс выполняется вручную на вкладке "Действия".
2. Извлечение содержимого репозитория с помощью действия actions/checkout.
3. Создание статических файлов сайта, если это требуется для вашего сайта.
4. Отправка статических файлов в качестве артефакта с помощью действия actions/upload-pages-artifact.
5. Развертывание артефакта с помощью действия actions/deploy-pages, если рабочий процесс был активирован отправкой в ветвь по умолчанию. Этот шаг пропускается, если рабочий процесс был активирован запросом на вытягивание.

Шаблоны рабочих процессов используют среду github-pagesразвертывания. Если в вашем репозитории не содержится среда github-pages, она будет создана автоматически. Рекомендуется добавить правило защиты развертывания, чтобы только ветвь по умолчанию могли развертываться в этой среде. Дополнительные сведения см. в разделе Управление средами для развертывания.

Устранение неполадок при публикации с помощью пользовательского GitHub Actions рабочего процесса

Сведения об устранении неполадок GitHub Actions рабочего процесса см. в разделе Мониторинг рабочих процессов.