JamesIves/github-pages-deploy-action

Что это?

Ключевые возможности

• 01Публикует любую папку в любую ветку, в том числе gh-pages и docs.
• 02Поддерживает публикацию в другой репозиторий с помощью personal access token.
• 03Поддерживает аутентификацию через GITHUB_TOKEN по умолчанию, PAT или SSH deploy key.
• 04Удаляет устаревшие файлы из ветки публикации, сохраняя исключённые файлы.
• 05Предоставляет режим dry-run, историю из одного коммита и выходной параметр deployment-status.

Сценарии использования

• Публикация статического сайта, собранного с помощью фреймворка вроде React или Vue, на GitHub Pages после каждого push.
• Публикация документации, сгенерированной инструментом сборки, в ветку docs.
• Отправка результата сборки из одного репозитория в Pages другого репозитория.
• Публикация из задания сборки на Windows с передачей артефактов в задание публикации на Ubuntu.

Быстрый старт

1. 1

   Добавьте файл workflow, который выполнит checkout репозитория, соберёт сайт и развернёт его с помощью action

2. 2

   Установите для permissions в workflow значение contents: write и укажите в folder путь к результатам сборки

3. 3

   В настройках репозитория выберите Pages, затем Deploy from a Branch и укажите ветку для деплоя (обычно gh-pages)

В подборках

Темы

Частые вопросы

Что такое github-pages-deploy-action?

GitHub Actions для автоматической сборки и публикации проекта на GitHub Pages с отправкой результата в любую ветку, например gh-pages или docs. GitHub Pages Deploy Action — это шаг GitHub Actions, который публикует папку из workflow, например каталог со сборкой, на GitHub Pages. Вы выбираете целевую ветку, в том числе gh-pages или docs; если такой ветки ещё нет, action создаст её. Также поддерживаются публикация в другой репозиторий и GitHub Enterprise.

github-pages-deploy-action можно использовать бесплатно? Какая у него лицензия?

github-pages-deploy-action распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

github-pages-deploy-action всё ещё поддерживается?

Активно поддерживается. Последний коммит в github-pages-deploy-action — 2 нояб. 2026 г..

Для чего можно использовать github-pages-deploy-action?

Публикация статического сайта, собранного с помощью фреймворка вроде React или Vue, на GitHub Pages после каждого push. Публикация документации, сгенерированной инструментом сборки, в ветку docs. Отправка результата сборки из одного репозитория в Pages другого репозитория. Публикация из задания сборки на Windows с передачей артефактов в задание публикации на Ubuntu.

Как установить github-pages-deploy-action?

Добавьте файл workflow, который выполнит checkout репозитория, соберёт сайт и развернёт его с помощью action Установите для permissions в workflow значение contents: write и укажите в folder путь к результатам сборки В настройках репозитория выберите Pages, затем Deploy from a Branch и укажите ветку для деплоя (обычно gh-pages)

Где скачать github-pages-deploy-action?

Исходный код и инструкции по установке — на GitHub: https://github.com/JamesIves/github-pages-deploy-action