OpeItcLoc03/admin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(runbook): mappa v0.28.0 (f1ba4e9) + gotcha ре-индекса tsvec

Browse Source
This commit is contained in:
vitya
2026-08-28 13:14:35 +03:00
parent e3f17ece50
commit 4def67cd0d
1 changed files with 6 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
.wiki/concepts/mappa-vds-deploy-runbook.md
View File

@@ -3,7 +3,7 @@ title: mappa — VDS deploy runbook (БД / образ / Portainer-стек 27 /
type: concept type: concept
tags: [mappa, vds, deploy, docker, portainer, traefik, postgres, runbook, meta] tags: [mappa, vds, deploy, docker, portainer, traefik, postgres, runbook, meta]
related: [[../entities/vds-kzntsv]], [[portainer-stack-management-vds]], [[mappa-prod-infra]] related: [[../entities/vds-kzntsv]], [[portainer-stack-management-vds]], [[mappa-prod-infra]]
updated: 2026-08-27 updated: 2026-08-28
--- ---
# mappa → VDS deploy runbook # mappa → VDS deploy runbook
@@ -22,7 +22,7 @@ mappa (#985). Не делать чужую часть.
- **Образ:** `registry.kzntsv.site/mappa:<version>` — тег = version из package.json, GIT_SHA передаётся - **Образ:** `registry.kzntsv.site/mappa:<version>` — тег = version из package.json, GIT_SHA передаётся
`--build-arg GIT_SHA=<sha>` (Dockerfile в корне репо, multi-stage node:22-alpine; `--build-arg GIT_SHA=<sha>` (Dockerfile в корне репо, multi-stage node:22-alpine;
**обязательный COPY `src/lib/schema.sql` → `dist/src/lib/schema.sql`** — tsc не копирует .sql, **обязательный COPY `src/lib/schema.sql` → `dist/src/lib/schema.sql`** — tsc не копирует .sql,
без него migrate() падает «schema.sql not found»). Прод на 2026-08-27 = **v0.27.0** (GIT_SHA aa87246). без него migrate() падает «schema.sql not found»). Прод на 2026-08-28 = **v0.28.0** (GIT_SHA f1ba4e9).
Deploy-паттерн: релизная ветка `deploy/vX.Y.Z` из батч-tip → бамп package.json → merge в master. Deploy-паттерн: релизная ветка `deploy/vX.Y.Z` из батч-tip → бамп package.json → merge в master.
- **Стек Portainer:** `mappa` (Id 27, endpoint 1). Source-of-truth compose: - **Стек Portainer:** `mappa` (Id 27, endpoint 1). Source-of-truth compose:
`admin/host-stacks/vds-kzntsv/mappa.compose.yml`. `admin/host-stacks/vds-kzntsv/mappa.compose.yml`.
@@ -108,3 +108,7 @@ ssh vds.kzntsv.site 'docker ps --filter name=mappa --format "{{.Status}}"'
Идемпотентен (ON CONFLICT DO NOTHING); повторный прогон добавляет только новые страницы. Идемпотентен (ON CONFLICT DO NOTHING); повторный прогон добавляет только новые страницы.
Первый прогон: 2539 тегов / 6555 рёбер; проверку «секреты не стали тегами» — скан имён Первый прогон: 2539 тегов / 6555 рёбер; проверку «секреты не стали тегами» — скан имён
на sk-/AKIA/JWT перед apply (имена password/token — теги-темы, не значения). на sk-/AKIA/JWT перед apply (имена password/token — теги-темы, не значения).
8. **Одноразовый ре-индекс tsvec при создании конфига токенизатора (v0.28.0, 2026-08-28)** —
миграция создаёт PG-конфиг `mappa` (гейт newly_created) и перестраивает tsvec ВСЕХ сущностей
(~13.5k коммитов). Старт после деплоя дольше обычного; health может отвечать 404/не стартовать
до ~1 мин — это ожидаемо, не паника. Проверять `docker ps` (health: starting) + повторять /health.