134 lines
9.9 KiB
Markdown
134 lines
9.9 KiB
Markdown
---
|
||
title: "sched — VDS deploy runbook (ядро daemon + admin API, MariaDB, стек sched)"
|
||
type: concept
|
||
tags: [sched, vds, deploy, docker, portainer, traefik, mariadb, runbook, scheduler]
|
||
related: [concepts/runbooks-index.md, concepts/portainer-stack-management-vds.md, concepts/sched-publish-runbook.md]
|
||
sources: []
|
||
updated: 2026-08-27
|
||
---
|
||
|
||
# sched → VDS deploy runbook (ядро daemon)
|
||
|
||
> **⚙️ СЛУЖЕБНЫЙ РАНБУК — только для администратора проекта `.admin`.**
|
||
> Применять/выполнять шаги может только **`.admin`** (оператор проекта admin).
|
||
> Из проекта не выносить: не копировать в другие вики, не пересказывать, не публиковать.
|
||
> Нужен деплой или прод-операция по этому ранбуку — **поставить задачу админу (`.admin`) и написать письмо**.
|
||
|
||
Развёртывание **ядра sched** (шедулер: daemon + in-process admin API) на инфра-VDS
|
||
(`89.253.255.94`), storage-адаптер **MariaDB** (общая MariaDB-стек 11, отдельная база `sched`).
|
||
Первый деплой — 2026-08-27 (task:790). Вводные с 2026-08-27: org/scope **@schedjs**
|
||
(github.com/schedjs/schedjs), self-host на MariaDB (не sqlite).
|
||
|
||
## Параметры
|
||
|
||
| Что | Значение |
|
||
|---|---|
|
||
| Хост | VDS kzntsv `89.253.255.94` |
|
||
| Стек Portainer | **Id 28**, name `sched`, endpointId **1** |
|
||
| Образ | `registry.kzntsv.site/sched-custom:0.12.1-mysql` (custom single-binary)
|
||
| Compose source-of-truth | `admin/host-stacks/vds-kzntsv/sched.compose.yml` |
|
||
| tasks.json source-of-truth | `admin/host-stacks/vds-kzntsv/sched.tasks.json` → VDS `/opt/stacks/sched/tasks.json` |
|
||
| Даемон | published `@schedjs/daemon@0.12.1` + `@schedjs/storage-mysql@0.4.0` + `@schedjs/admin-api@0.3.0` + `@schedjs/mcp@0.4.1` + `@schedjs/ui@0.3.0` |
|
||
| БД | MariaDB `mariadb:3306` (сеть `shared-dbs`), база `sched`, роль `sched@%`. Креды: `pass sched/mysql` |
|
||
| Admin API | `https://sched.vds.kzntsv.site` (traefik websecure, letsEncrypt). `SCHED_ADMIN_KEY` = `pass sched/admin-key` |
|
||
| mem_limit | `512m` (канон app-стеков) |
|
||
| Сети | `shared-dbs` + `proxy` (обе external) |
|
||
|
||
## Артефакты
|
||
|
||
- **Код/пакеты:** публикуются на npm `@schedjs/*` (см. `sched-publish-runbook`). Dev-исходники — репо `sched` (Gitea).
|
||
- **Dockerfile.** Стандартный `apps/daemon/Dockerfile` собирает из `@schedjs/daemon`. Для MariaDB — **композиция** адаптера. В репо добавлен `apps/daemon/Dockerfile.mysql` (public npm, без токена):
|
||
```dockerfile
|
||
FROM node:24-alpine
|
||
WORKDIR /app; ENV NODE_ENV=production
|
||
RUN echo '{"name":"schedd","private":true,"packageManager":"yarn@4.18.0"}' > package.json \
|
||
&& corepack enable && printf 'nodeLinker: node-modules\nnpmMinimalAgeGate: 0\n' > .yarnrc.yml \
|
||
&& CI=1 yarn add @schedjs/daemon@0.12.1 @schedjs/storage-mysql@0.4.0 \
|
||
&& rm -f .yarnrc.yml && yarn cache clean
|
||
ENV PATH="/app/node_modules/.bin:${PATH}"; EXPOSE 8080; VOLUME ["/data"]; ENTRYPOINT ["schedd"]
|
||
```
|
||
Сборка: `docker build -f apps/daemon/Dockerfile.mysql -t registry.kzntsv.site/sched-daemon:0.12.1-mysql apps/daemon`.
|
||
Единственный слой, который важно композить — `@schedjs/storage-mysql` (иначе `--storage mysql` падает `ERR_MODULE_NOT_FOUND`).
|
||
|
||
## Первичный деплой (сделано 2026-08-27)
|
||
|
||
**0. База (однократно).**
|
||
```bash
|
||
# на VDS, root внутри mariadb контейнера
|
||
docker exec mariadb mariadb -uroot -p"$ROOT_PW" -e "
|
||
CREATE DATABASE IF NOT EXISTS sched CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||
CREATE USER IF NOT EXISTS 'sched'@'%' IDENTIFIED BY '<pw>';
|
||
GRANT ALL PRIVILEGES ON sched.* TO 'sched'@'%'; FLUSH PRIVILEGES;"
|
||
```
|
||
Креды → `pass insert -m sched/mysql` (user/pass/db/host).
|
||
|
||
**1. Образ (custom single-binary).** `apps/daemon/Dockerfile.custom` собирает один образ с опубликованными `@schedjs/{daemon,storage-mysql,admin-api,mcp,ui}` + `custom-entry.mjs` — один HTTP-сервер на `:8080`:
|
||
- `/api/*` → админ API (health open, остальное Bearer `SCHED_ADMIN_KEY`)
|
||
- `/mcp` → Streamable HTTP MCP (projection of admin API, `SCHED_MCP_READONLY=1` read-only)
|
||
- `/` → UI morda (web-components)
|
||
- `/sched-ui.bundle.js` → статический UI-бандл
|
||
Сборка: `docker build -f apps/daemon/Dockerfile.custom -t registry.kzntsv.site/sched-custom:0.12.1-mysql apps/daemon`.
|
||
→ ЕДИНЫЙ бинарь: даемон + UI-морда + MCP не плодит отдельные контейнеры (обратная связь vitya).
|
||
`createDaemon` даёт `engine`+`storage` (admin server НЕ bind — маршрутизация своя). MCP/морда импортируются по **file-URL** (subpath-импорты заблокированы npm `exports`-маской).
|
||
|
||
**2. tasks.json.** Ядро стартует с `{"tasks":[]}` (воркеры — отдельными тасками). Закинуть на VDS:
|
||
```bash
|
||
scp sched.tasks.json vds.kzntsv.site:/tmp/ ; ssh vds.kzntsv.site 'sudo mkdir -p /opt/stacks/sched && sudo cp /tmp/sched.tasks.json /opt/stacks/sched/tasks.json && sudo chmod 644 /opt/stacks/sched/tasks.json'
|
||
```
|
||
|
||
**3. Стек Portainer.** compose в `host-stacks/vds-kzntsv/sched.compose.yml`, env через Portainer API (`SCHED_DB_PASS`, `SCHED_ADMIN_KEY`). Create `standalone/string?endpointId=1`.
|
||
|
||
**Ключевой момент — MYSQL_URL + TLS.** MariaDB-стек 11 запущен с `--require-secure-transport=ON` и self-signed TLS. Подключение через `mariadb:3306` (внутренняя сеть `shared-dbs`) **без TLS НЕ проходит**: `fatal: Connections using insecure transport are prohibited`. Фикс — ssl в connstring:
|
||
```
|
||
MYSQL_URL=mysql://sched:${SCHED_DB_PASS}@mariadb:3306/sched?ssl={"rejectUnauthorized":false}
|
||
```
|
||
`mysql2` парсит `ssl` из query-string (`ConnectionConfig.parseUrl`), self-signed → `rejectUnauthorized:false`.
|
||
|
||
## Реденплой (обновление образа)
|
||
|
||
```bash
|
||
# 1. build + push нового тега (см. артефакты)
|
||
# 2. на VDS docker pull ДО restart (иначе застрянет на старом digest)
|
||
ssh vds.kzntsv.site 'docker pull registry.kzntsv.site/sched-daemon:<new>'
|
||
# 3. source-of-truth compose: сменить image: тег
|
||
# 4. Portainer PUT /api/stacks/28?endpointId=1 {stackFileContent, env:[...], prune:false, pullImage:true}
|
||
```
|
||
⚠️ PUT сбрасывает env-массив, если не передать `env` (gotcha 4b portainer-канон).
|
||
⚠️ Синхронизировать source-of-truth compose после PUT (иначе следующий redeploy из гита откатит тег).
|
||
|
||
## Verify
|
||
|
||
```bash
|
||
# контейнер
|
||
docker ps -a --filter name=schedd --format "{{.Status}}" # Up ... (healthy)
|
||
docker logs --tail 5 schedd # "daemon started (tasks=..., storage=mysql db=sched, ...)"
|
||
# health (публичный, открыт)
|
||
curl -ksS https://sched.vds.kzntsv.site/api/health # {"ok":true,"uptimeMs":...,"version":"0.12.1"}
|
||
# авторизованный доступ (SCHED_ADMIN_KEY = Bearer)
|
||
curl -ksS -H "Authorization: Bearer $AK" https://sched.vds.kzntsv.site/api/tasks # {"tasks":[]}
|
||
curl -ksS https://sched.vds.kzntsv.site/api/tasks # 401 (без Bearer)
|
||
# таблицы в MariaDB
|
||
docker exec mariadb mariadb -uroot -p"$ROOT_PW" -e "USE sched; SHOW TABLES; SELECT version FROM sched_schema_version;"
|
||
# → scheduled_tasks, schedules, task_runs, sched_schema_version; version = 6
|
||
```
|
||
|
||
## Rollback
|
||
|
||
PUT стека 28 с предыдущим тегом образа (или `{"tasks":[]}` пустой cron). Старые теги в registry.
|
||
|
||
## Gotchas
|
||
|
||
1. **TLS к MariaDB обязателен** — `--require-secure-transport=ON`, без `?ssl={"rejectUnauthorized":false}` → daemon в restart-loop с `fatal: insecure transport prohibited`.
|
||
2. **basicAuth — оставлен ВЫКЛ** (первый деплой). У daemon самодостаточный `SCHED_ADMIN_KEY` (Bearer) — второй слой. `/api/health` открыт (для мониторинга), всё остальное 401 без Bearer. Если нужен front-layer basicAuth — добавить middleware в traefik labels (сгенерировать bcrypt-хэш `htpasswd -nbB`), НО хэш передавать аккуратно (traefik может не принять `$2y$` при кривой передаче).
|
||
3. **`--admin-host 0.0.0.0`** — daemon слушает на всех интерфейсах внутри `proxy`-сети для traefik. Наружу VDS-порт НЕ публикуется (нет `ports:`), только через traefik.
|
||
4. **Воркеры НЕ в этом ядре** — `task:1190` (yt-digest), `task:1311` (tg-digest) отдельные; добавляются как задачи в `tasks.json`.
|
||
5. **`SCHED_ADMIN_KEY`** — в `pass sched/admin-key` (не basic-auth; это разные вещи).
|
||
6. **storage-mysql сам применяет миграции** на старте (`sched_schema_version`, версия 6) — внешний инструментарий не нужен, но БД должна быть доступна с правами на CREATE/ALTER.
|
||
|
||
## Связи
|
||
|
||
- [[concepts/portainer-stack-management-vds.md]] — общий Portainer-канон (JWT, gotchas, mem_limit)
|
||
- [[concepts/sched-publish-runbook.md]] — паблиш @schedjs на npm/GitHub
|
||
- [[concepts/runbooks-index.md]] — индекс ранбуков
|
||
- Репо sched: `docs/content/docs/13.self-hosting.md` — композиция storage-адаптеров, security model
|