Конфигурация и артефакты для сервисов экосистемы OneScript. Прод — две ноды (A — публичный edge, B — MinIO, Grafana, hostmetrics), каталог стека /opt/oscript, оркестрация — Docker Compose v2 через ops/dc.sh.
Краткая справка для агентов — AGENTS.md.
| Домен | Сервис |
|---|---|
| oscript.io | Основной сайт |
| hub.oscript.io | OpenHub |
| build.oscript.io | Jenkins |
| s3.oscript.io | MinIO (после сплита — данные на B) |
| grafana.oscript.io | Grafana, метрики, логи, трассы |
compose/ — модульный стек (node_a, node_b, overrides)
env/ — образцы .env (node_a, node_b)
ops/dc.sh — единая команда compose на нодах
ansible/ — роли и site.yml (inventory и vault — на B, вне git)
web/nginx/ — reverse proxy и TLS
monitoring/ — observability
minio/ jenkins/ S3/ bot/
Секреты — в .env (не в git) и Ansible vault. Образцы: env/node_a.env.example, openhub.env.example, minio/.env.example.
Исходники сайта лежат не в этом репозитории, а в отдельном проекте EvilBeaver/OneScript.WebSite. Здесь — только инфраструктура, которая запускает готовый образ oscript/backend (сервис site).
| Часть | Что это | Куда собирается |
|---|---|---|
frontend/ |
VitePress (документация и статика) | backend/data/wwwroot → том wwwroot (публикует Jenkins) |
backend/ |
приложение OneScript (фреймворк autumn) | Docker-образ oscript/backend |
Бэкенд поднимает веб-сервер на порту 3030 (backend/src/Классы/Бэкенд.os) и отдаёт два вида контента:
- статику фронтенда из
server.rootDir/wwwroot— это томwwwroot(/app/data/wwwroot), наполняется Jenkins-ом без перезапуска контейнера; - файлы релизов из
filesDir/download/versions— это томweb_content(/var/www/oscript.io).
Маршрутизация (backend/src/Классы/Роутер.os):
| Маршрут | Обработчик | Назначение |
|---|---|---|
downloads/… |
ОбработчикСкачивания |
скачивание дистрибутивов (/downloads/<version>/<type>?bitness) |
api/archive/… |
ОбработчикApi |
метаданные версий (JSON) |
api/publish |
ПубликацияВерсий |
вебхук публикации сборок |
| всё остальное | статика | фронтенд из wwwroot |
Конфиг backend/src/autumn-properties.json переопределяется переменными окружения; точка в ключе соответствует подчёркиванию в имени env-переменной.
| Ключ конфига | Env | Значение на проде | Назначение |
|---|---|---|---|
filesDir |
filesDir |
/var/www/oscript.io |
каталог файлов релизов (том web_content) |
server.rootDir |
server_root |
/app/data |
каталог сервера; wwwroot — статика фронтенда (том wwwroot) |
server.port |
server.port |
3030 |
порт веб-сервера |
publish.secret |
publish_secret |
из .env на A |
секрет вебхука публикации сборок |
CI/CD сайта — Jenkins (build.oscript.io, нода A), пайплайн задан Jenkinsfile в корне репо сайта:
Build content— node-контейнер собирает VitePress (npm run docs:build) вbackend/data/wwwroot; томweb_contentподключён как/var/www, чтобы страницы архива версий читали релизы (VITEPRESS_FILES_DIR=/var/www/oscript.io).Publish content—rsyncсобранных файлов в named volumeos_wwwroot(WWWROOT_VOLUMEвJenkinsfile). Это томwwwroot, смонтированный вsiteкак/app/data/wwwroot: новый фронт отдаётся без пересоздания контейнера.Create container—docker buildx build --load -t oscript/backend .собирает образ и кладёт его в Docker ноды A (Jenkins имеет доступ к/var/run/docker.sock). На работающий том статики эта стадия не влияет.
Том статики на хосте называется os_wwwroot: в compose/node_a.compose.yaml он объявлен как external с явным именем, и это имя обязано совпадать с WWWROOT_VOLUME в Jenkinsfile сайта.
Пересоздавать контейнер нужно только при изменениях кода бэкенда (или его зависимостей):
cd /opt/oscript && ./ops/dc.sh up -d siteПравки контента и вёрстки фронтенда в пересоздании не нуждаются.
- Обновление самого сайта (код фронтенда/бэкенда): правка в
OneScript.WebSite→ push → Jenkins собирает контент и публикует его в томwwwroot. Пересозданиеsite(./ops/dc.sh up -d site) — только при изменениях бэкенда. - Публикация сборок OneScript (дистрибутивы для скачивания): GitHub Actions репозитория OneScript шлёт
POST /api/publishс подписью HMAC-SHA256 (заголовокX-OneScript-Signature-256). nginx проксирует наsite:3030; бэкенд проверяетpublish.secret, скачивает файлы с GitHub вfilesDir/download/versionsи атомарно заменяет каталоги каналов (latest,preview,night-build,lts,lts-dev). Это не деплой сайта.
Сервис s3-sync каждые 12 часов зеркалирует во внешний S3 только каталог hub.oscript.io внутри тома web_content (подкаталог задан SYNC_SUBDIR в S3/Dockerfile).
- Статика фронтенда живёт в томе
wwwroot, а не в образе: послеCreate containerв образе лежит лишь исходная (COPY data/) копия, но она перекрыта монтированием тома. Поэтому «свежесть» сайта определяетPublish content, а не пересборка образа. frontend/.github/workflows/deploy.yml— черновик (деплой в GitHub Pages), не используется; рабочий CI — Jenkins.
Все тома с данными объявлены в compose как external: true с явным name:. Compose такие тома не создаёт и не удаляет, поэтому ./ops/dc.sh down -v сносит только контейнеры и сети — данные остаются.
| Ключ в compose | Том на хосте | Что внутри |
|---|---|---|
wwwroot |
os_wwwroot |
статика фронтенда (создаёт и наполняет Jenkins) |
web_content |
os_web_content |
релизы (filesDir) и hub.oscript.io для s3-sync |
jenkins_home |
os_jenkins_home |
/var/jenkins_home |
postgres_data |
os_postgres_data |
данные бывшего opm_hub_db (сервис снят) |
openhub_data, openhub_postgres_data |
os_openhub_data, os_openhub_postgres_data |
данные OpenHub и его БД |
minio_data, lgtm_data (нода B) |
os_minio_data, os_lgtm_data |
MinIO, Grafana/LGTM |
Обратная сторона: external-том compose не создаёт, поэтому на новой ноде перед первым up тома из таблицы должны существовать:
docker volume create os_wwwroot # и остальные тома ноды из таблицыos_wwwroot на ноде A создаётся сам при первой публикации Jenkins (Publish content). Если статику нужно отдать из образа ещё до первой публикации — скопировать запечённую в образе копию:
docker run --rm -v os_wwwroot:/dst --entrypoint sh oscript/backend \
-c 'cp -a /app/data/wwwroot/. /dst/'Проверка на ноде: docker volume ls | grep os_wwwroot и docker volume inspect os_wwwroot --format '{{index .Labels "com.docker.compose.project"}}' — метки проекта быть не должно (том не управляется compose).
# .env: COMPOSE_PROJECT_NAME=os и COMPOSE_FILE=… (см. env/*.env.example)
./ops/dc.sh config
./ops/dc.sh up -dПервые сертификаты: ./init-letsencrypt.sh. Новый домен: конфиг в web/nginx/sites-enabled/, затем ./add-letsencrypt-domain.sh <домен>.
cd /opt/oscript
ansible-playbook ansible/site.yml \
-e @/opt/oscript-secrets/vault.yml \
--vault-password-file /opt/oscript-secrets/vault_pass \
--tags common --limit node_bПроверка каркаса без хостов: ./ansible/test/run.sh.
./web/nginx/test/run.sh
./monitoring/test/run.sh
./ansible/test/run.sh- OpenHub с нуля —
openhub.env.example, первый админ через/setupна hub.oscript.io