Деплой документации
Документация автоматически собирается из main и публикует содержимое .vitepress/dist.
Проверяем не только главную, но и прямое открытие вложенной статьи.
Параметры прочитаны через API DigitalOcean 28 сентября 2026 года. Это действующий деплой документации, а не генератора сайтов.
Настройки
| Параметр | Проверенное значение |
|---|---|
| Приложение | bonsite-docs |
| Тип компонента | Static site |
| Репозиторий | Agentfy/bonsite |
| Ветка | main, deploy on push включён |
| Source directory | docs |
| Build command | bun run build |
| Output directory | .vitepress/dist |
Публичный адрес: Bonsite DOCS. Управление static-site компонентами описано в документации DigitalOcean.
Перед слиянием
Из корня репозитория:
sh
bun install --cwd docs --frozen-lockfile
bun run --cwd docs buildПроверить ссылки и якоря в собранных HTML, открыть изменённые страницы, поиск и мобильное меню. В docs нет lint-скрипта; успешную сборку нельзя называть успешным lint.
Публикация и проверка
После принятия изменений слить PR в main. Найти деплой именно этого commit и дождаться ACTIVE. Открыть главную, изменённый раздел и отдельную статью напрямую, затем обновить страницу браузера. Убедиться, что появились новый текст и assets, а не только HTTP 200.
Известные ошибки
Не найдена output directory. Автоопределение не гарантирует поиск скрытой .vitepress/dist. Сравнить фактическую папку сборки с явной настройкой компонента.
В меню работает, по ссылке 404. Этот static-хостинг не сопоставлял /market/competition с competition.html. Поэтому cleanUrls: false: отдельные статьи используют .html, разделы с index.html — адрес папки. Прямые ссылки в Vue-компонентах тоже должны указывать на существующий файл. Старые адреса статей без расширения не получили автоматических redirect.
Деплой активен, видна старая версия. Сначала сравнить source commit и ссылку на asset. Затем проверить кеш и новую сессию браузера. Не повторять публикацию наугад.
Откат
Вернуть предыдущий проверенный commit содержимого отдельным revert и дать штатному автодеплою завершиться. После отката повторить проверку главной и вложенного URL. Для срочного отката через панель сначала подтвердить возможности провайдера и выбранную версию; такая процедура здесь отдельно не проверялась.