OPS - DEPLOY: wire Ops Agents Gateway into Synology runbooks

infra/synology/README.md

@@ -47,7 +47,7 @@ http://task.nas.nodedc:18090
 - `deploy-current.sh` синхронизирует compose, Caddyfile, Authentik templates и опционально Launcher source в NAS mount.
 - `backup-current.sh` делает snapshot Launcher runtime/uploads/Auth templates/config и готовит команду `pg_dump` для Authentik Postgres.
 - Tasker поднимается отдельным compose из `NODEDC_TASKMANAGER/plane-app/docker-compose.yaml` на порту `18090`.
-- Ops Agents Gateway поднимается отдельным compose из `NODEDC_TASKMANAGER_CODEXAPI/docker-compose.synology.yml` на `127.0.0.1:18190`; Synology reverse proxy должен вести `ops-agents.nodedc.ru` на этот порт, а не на `18090`.
+- Ops Agents Gateway поднимается отдельным compose из `NODEDC_TASKMANAGER_CODEXAPI/docker-compose.synology.yml` на `172.22.0.222:18190`; Synology reverse proxy должен вести `ops-agents.nodedc.ru` на этот порт, а не на `18090`.
 
 ## Синхронизация текущего состояния
 
@@ -57,11 +57,33 @@ http://task.nas.nodedc:18090
 cd /Users/dcconstructions/Downloads/mnt/NODEDC/platform
 NAS_ROOT=/Volumes/docker/nodedc-platform \
 LAUNCHER_REPO=/Users/dcconstructions/Downloads/mnt/data/nodedc_launcher \
+TASKER_REPO=/Users/dcconstructions/Downloads/mnt/data/dc_taskmanager/NODEDC_TASKMANAGER \
+TASKER_CHANGED_BASE=533f8c6 \
+GATEWAY_REPO=/Users/dcconstructions/Downloads/mnt/data/NODEDC_TASKMANAGER_CODEXAPI \
 ./infra/synology/deploy-current.sh
 ```
 
 Скрипт не запускает Docker сам: на NAS `sudo` интерактивный, поэтому команды применения печатаются в конце.
 
+Что синхронизируется:
+
+- Platform compose/Caddy/Auth templates.
+- Launcher source в `/volume1/docker/nodedc-platform/launcher/source`.
+- Tasker `plane-app/docker-compose.yaml` и, если задан `TASKER_CHANGED_BASE`, только изменённые source-файлы из диапазона `TASKER_CHANGED_BASE..HEAD`.
+- Ops Agents Gateway source в `/volume1/docker/nodedc-platform/ops-agents`.
+
+Полный sync Tasker source по SMB тяжёлый для Plane fork. Использовать его только осознанно:
+
+```bash
+TASKER_SYNC_SOURCE=1 ./infra/synology/deploy-current.sh
+```
+
+Секретные runtime env-файлы не перетираются:
+
+- `/volume1/docker/nodedc-platform/platform/.env.synology`
+- `/volume1/docker/nodedc-platform/tasker/plane-app/.env.synology`
+- `/volume1/docker/nodedc-platform/ops-agents/.env`
+
 ## Backup текущего состояния
 
 С Mac, при смонтированном `/Volumes/docker`:
@@ -79,6 +101,18 @@ NAS_ROOT=/Volumes/docker/nodedc-platform ./infra/synology/backup-current.sh
 bash /volume1/docker/nodedc-platform/backups/platform-current-YYYYMMDD-HHMMSS/run-authentik-db-dump-on-synology.sh
 ```
 
+Если планируются изменения Tasker backend/schema, дополнительно выполнить:
+
+```bash
+bash /volume1/docker/nodedc-platform/backups/platform-current-YYYYMMDD-HHMMSS/run-tasker-db-dump-on-synology.sh
+```
+
+Если Ops Agents Gateway уже был запущен и там есть production tokens/grants/audit, дополнительно выполнить:
+
+```bash
+bash /volume1/docker/nodedc-platform/backups/platform-current-YYYYMMDD-HHMMSS/run-ops-agents-db-dump-on-synology.sh
+```
+
 ## Что нужно перед запуском
 
 - Собрать или загрузить `linux/amd64` images: