Развернуть сайт из GitHub или GitLab с помощью Plesk
Подключите репозиторий GitHub или GitLab к Plesk, развертывайте сайт вручную или автоматически при каждом push с помощью веб-хука и устраняйте самые распространенные ошибки.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
В этом руководстве описано, как связать репозиторий GitHub или GitLab с вашим сайтом в Plesk. После настройки обновить сайт можно будет простой командой git push.
Принцип такой: вы отправляете изменения в GitHub или GitLab, Plesk получает новые коммиты и копирует файлы активной ветки в папку вашего сайта.
Предварительные требования
- Доступ к панели Plesk (см. Подключение к интерфейсу Plesk).
- Репозиторий GitHub или GitLab с вашим сайтом.
- Права администратора репозитория для добавления ключа и веб-хука. В GitLab требуется роль Maintainer или Owner.
В этом руководстве используется папка httpdocs, стандартная для основного домена. У дополнительного домена папка может быть другой: проверьте значение Корневая папка в разделе Хостинг и DNS > Хостинг.
Шаг 1: подготовьте репозиторий
Содержимое корня репозитория копируется в целевую папку, по умолчанию /httpdocs. Таким образом, файл index.html в корне репозитория становится файлом httpdocs/index.html.
Никогда не добавляйте в систему контроля версий секреты и сгенерированные файлы. Пример файла .gitignore:
.env
node_modules/
vendor/
*.logФайлы, игнорируемые Git, не развертываются. Поэтому файл .env нужно создать непосредственно на сервере.
Шаг 2: добавьте репозиторий в Plesk
- Перейдите в раздел Сайты и домены и найдите ваш домен.
- Нажмите Git. Если репозиторий уже существует, нажмите Добавить репозиторий.
- Выберите Удаленный хостинг Git (например, GitHub или BitBucket). Этот вариант подходит и для GitLab.
- В поле удаленного репозитория введите адрес вашего репозитория.
| Тип репозитория | Формат адреса |
|---|---|
| Публичный | https://github.com/your-account/my-site.git |
| Приватный, GitHub | git@github.com:your-account/my-site.git |
| Приватный, GitLab | git@gitlab.com:your-account/my-site.git |
Для приватного репозитория рекомендуется формат SSH: в этом случае Plesk создаст ключ и покажет поле Открытый ключ SSH. Пока не подтверждайте добавление и перейдите к шагу 3.
Шаг 3: разрешите Plesk читать приватный репозиторий
Скопируйте содержимое поля Открытый ключ SSH и добавьте его как ключ развертывания.
На GitHub:
- Откройте репозиторий, затем Settings > Deploy keys.
- Нажмите Add deploy key.
- Укажите название ключа в поле Title, например
Plesk, и вставьте ключ в поле Key. - Оставьте флажок Allow write access снятым: Plesk нужно только чтение репозитория.
- Нажмите Add key.
На GitLab:
- Откройте проект, затем Settings > Repository.
- Разверните раздел Deploy keys и выберите Add new key.
- Укажите название ключа и вставьте его.
- Оставьте флажок Grant write permissions to this key снятым и сохраните.
Шаг 4: выберите режим развертывания
Вернитесь в Plesk, в раздел Ваш сайт:
-
Выберите Режим развертывания:
Режим Результат Автоматическое развертывание Полученные коммиты публикуются сразу Развертывание вручную Коммиты получаются, но публикуются только по вашему запросу Без развертывания (хостинг репозитория) Ничего не публикуется -
Проверьте значение Целевая папка. Для обычного сайта оставьте
/httpdocs. -
Нажмите ОК. После этого Plesk клонирует репозиторий.
Для рабочего сайта режим развертывания вручную безопаснее, пока ваш процесс не отлажен: в автоматическом режиме любая ошибка, отправленная в активную ветку, сразу попадает на сайт.
Шаг 5: выберите ветку и выполните развертывание
- На странице Git нажмите Изменить ветку и путь.
- В меню Ветка выберите рабочую ветку, например
main, и подтвердите выбор. - Нажмите Получить обновления.
- В режиме развертывания вручную нажмите Развернуть из репозитория (или Развернуть).
Развертывается только активная ветка.
Шаг 6: настройте автоматизацию с помощью веб-хука
Без веб-хука Plesk не узнает о новом коммите, и вам придется нажимать Получить обновления. Веб-хук уведомляет Plesk при каждом git push.
В Plesk нажмите Настройки репозитория и скопируйте значение Адрес для веб-хука. Обращайтесь с ним как с секретом: любой, кто его знает, может запустить получение изменений.
На GitHub:
- Откройте Settings > Webhooks и нажмите Add webhook.
- Вставьте адрес в поле Payload URL.
- В поле Content type выберите
application/json. - Оставьте отправку только события
push(Just the push event). - Убедитесь, что флажок Active установлен, и нажмите Add webhook.
На GitLab:
- Откройте Settings > Webhooks и выберите Add new webhook.
- Вставьте адрес в поле URL.
- В разделе Trigger установите флажок Push events.
- Оставьте параметр Enable SSL verification включенным, если сертификат Plesk действителен.
- Выберите Add webhook.
Шаг 7: запускайте действия после развертывания
Некоторым проектам нужно выполнить действие после копирования файлов, например перезапустить приложение или очистить кэш.
- В разделе Настройки репозитория установите флажок Включить дополнительные действия развертывания.
- Введите по одной команде в строке.
Например, чтобы перезапустить приложение Node.js, размещенное в папке httpdocs:
cd httpdocs
mkdir -p tmp
touch tmp/restart.txtЧтобы установить зависимости и скомпилировать этот же проект, заменив 24 на используемую версию Node.js:
export PATH=/opt/plesk/node/24/bin:$PATH
cd httpdocs
npm ci
npm run build
mkdir -p tmp
touch tmp/restart.txtДля проекта Laravel см. руководство Разместить сайт Laravel в Plesk.
Проверка результата
-
Измените файл, изменения в котором будут заметны на сайте, и отправьте правку:
Терминалgit add . git commit -m "Проверка развертывания" git push origin main -
В Plesk на странице Git убедитесь, что последним отображается ваш коммит. История доступна в разделе Журналы записи изменений в репозиторий.
-
Обновите страницу
https://ваш-домен.com/и проверьте изменение. -
Проверьте доставку веб-хука:
- GitHub: Settings > Webhooks, откройте веб-хук, затем Recent deliveries;
- GitLab: Settings > Webhooks, Edit, затем Recent events. Кнопка Test > Push events также позволяет отправить тестовое событие.
Возврат к предыдущей версии
Отмените ошибочный коммит и отправьте результат:
git revert HEAD
git push origin mainНовое развертывание восстановит файлы. Если выполнялись миграции базы данных, эта операция их не отменит.
Устранение неполадок
Permission denied (publickey)
Открытый ключ Plesk не был добавлен в репозиторий или был добавлен в другой репозиторий. Скопируйте его из Plesk еще раз и проверьте список ключей развертывания.
Key is already in use на GitHub
Этот ключ развертывания уже связан с другим репозиторием. Удалите его из того репозитория или добавьте в отдельную учетную запись GitHub.
Repository not found или Authentication failed
Адрес указан неверно, репозиторий является приватным, а вы используете адрес HTTPS без учетных данных, или истек срок действия токена. Изменить адрес репозитория в Plesk нельзя, поэтому удалите его с помощью кнопки Удалить репозиторий и добавьте заново. Уже опубликованные файлы сохранятся.
После push сайт не обновляется
Проверьте по порядку:
- что коммит отправлен в активную ветку;
- что не выбран режим Развертывание вручную или Без развертывания;
- что веб-хук получен: это видно в истории GitHub или GitLab.
Веб-хук завершается ошибкой сертификата
Если панель Plesk использует самозаверенный сертификат, подключение по HTTPS может завершиться ошибкой. В таком случае Plesk рекомендует указать http:// в начале URL веб-хука. Поскольку URL будет передаваться без шифрования, используйте это решение только временно и сообщите о проблеме в поддержку.
GitLab сообщает, что веб-хук отключен
GitLab временно отключает веб-хук после четырех неудачных попыток подряд и окончательно — после сорока. Устраните причину и отправьте успешный тестовый запрос, чтобы снова включить его.
С сайта исчезли файлы
Файл, удаленный из репозитория, при развертывании удаляется и с сайта. Храните файлы, загружаемые пользователями, в папке вне системы контроля версий, а утраченные файлы восстановите из резервной копии.
Целевая папка отклонена
Два репозитория одного домена не могут использовать одну и ту же папку развертывания. Выберите другое значение в поле Целевая папка.
Продолжает отображаться старая страница
Файл index.html может иметь приоритет над вашим index.php, в частности страница, созданная Plesk по умолчанию. Удалите его из httpdocs, если он не относится к вашему проекту, и очистите кэш браузера.
npm: command not found в действиях развертывания
В этом контексте путь к инструментам не загружен. Добавьте строку export PATH=/opt/plesk/node/24/bin:$PATH, указав нужную версию. Если ошибка сохраняется, вероятно, используется chroot-окружение.