Публикация документации
Документация Securify публикуется как Static Site в DigitalOcean App Platform. Настройки хранятся в .do/app.yaml в корне репозитория.
Отдельное приложение в docs
Текущее приложение: security-docs, ID f27bce41-9a8f-4b54-a794-a8ac28841c6e, компонент securify-docs. Открыть сайт. Push в main запускает автоматическую публикацию. Используйте существующее приложение; не создавайте копию по App Spec.
Документация — самостоятельное приложение: docs/package.json содержит VitePress и команды запуска, а docs/bun.lock фиксирует зависимости. В поле Source directories нужно указать docs.
Настройка через панель DigitalOcean
- Выбрать репозиторий
Agentfy/securify, веткуmain. - В Source directories указать
docs. - На следующем шаге выбрать тип компонента Static Site.
- Указать настройки:
| Поле | Значение |
|---|---|
| Source directory | docs |
| Build command | bun run build |
| Output directory | .vitepress/dist |
| Index document | index.html |
| Error document | 404.html |
| Autodeploy | Включить для main |
Build environment: BUN_VERSION | 1.3.14 |
Run command для статического сайта не нужен. Зависимости устанавливает buildpack. Поле packageManager в docs/package.json позволяет Bun buildpack установить также Node.js, который использует CLI VitePress; версия Node.js задана в engines.
Секреты из локального .env для сборки документации не требуются.
Конфигурация в репозитории
.do/app.yaml описывает существующее приложение. При необходимости обновляйте его конфигурацию через панель, API или doctl; не создавайте дубликат. Наличие файла в репозитории само по себе не применяет изменения инфраструктуры.
После push дождитесь состояния deployment ACTIVE. Проверьте главную, /documentation.html, /architecture/v0.1.0.html, /market/ и поиск. Неизвестный URL должен возвращать 404. Успешный push не подтверждает публикацию.
Локальная проверка
sh
cd docs
bun install --frozen-lockfile
bun run build
bun run previewПубликуется только содержимое docs/.vitepress/dist, а не весь репозиторий.