Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

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

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

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

People with admin or maintainer permissions for a repository can configure a publishing source for a GitHub Pages site.

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

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

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

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

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

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

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

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

  2. В GitHubперейдите в репозиторий сайта. 1. Нажмите Параметры под именем репозитория. Кнопка параметров репозитория

  3. В разделе «Код и автоматизация» на боковой панели щелкните Страницы .

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

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

    Раскрывающееся меню для выбора источника публикации

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

  7. Выберите команду Сохранить. Кнопка для сохранения изменений в параметрах источника публикации

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

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

Если вы выберете папку 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 Pages с помощью пользовательского рабочего процесса GitHub Actions находится в бета-версии и может измениться.

Чтобы настроить публикацию сайта с помощью GitHub Actions, выполните следующие действия:

  1. В GitHubперейдите в репозиторий сайта. 1. Нажмите Параметры под именем репозитория. Кнопка параметров репозитория

  2. В разделе «Код и автоматизация» на боковой панели щелкните Страницы .

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

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

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

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

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

Во время настройки публикации сайта с помощью GitHub Actions GitHub предложит начальные рабочие процессы, подходящие для распространенных сценариев публикации. Обычно рабочий процесс состоит из следующих действий:

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

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

Примечание. Файл CNAME в репозитории не добавляет и не удаляет личный домен автоматически. Вместо этого личный домен необходимо настроить в параметрах репозитория или с помощью API. Дополнительные сведения см. в разделе "Управление личным доменом для сайта GitHub Pages" и в справочной документации по API Pages.

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

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