Initial server source import

2026-09-30 20:30:56 +03:00
commit 170dd941b9
498 changed files with 261563 additions and 0 deletions
@@ -0,0 +1,77 @@
+# TRUF worker: шпаргалка Docker
+
+Откройте Bash или PowerShell в корне bundle с `compose.yaml`, worker image archive
+и helper scripts. Нужен Docker Engine с Compose v2 либо Docker Desktop.
+
+## Один раз
+
+Создайте локальный `worker-install.yaml` через текстовый редактор:
+
+```yaml
+server: https://pregnant.horsecock.store
+token: PASTE_DEVICE_TOKEN_HERE
+parallelism: 1
+```
+
+Bash:
+
+```sh
+chmod 600 ./worker-install.yaml
+chmod 700 ./workerctl.sh
+docker load -i truf-worker-linux-x86_64.tar.gz
+docker compose run --rm -T worker install --config - < ./worker-install.yaml
+rm -- ./worker-install.yaml
+docker compose run --rm worker doctor --json
+```
+
+PowerShell:
+
+```powershell
+docker load -i .\truf-worker-linux-x86_64.tar.gz
+Get-Content -Raw .\worker-install.yaml |
+  docker compose run --rm -T worker install --config -
+Remove-Item -LiteralPath .\worker-install.yaml
+docker compose run --rm worker doctor --json
+```
+
+## Каждый день
+
+Bash:
+
+```sh
+docker compose up -d
+./workerctl.sh status
+./workerctl.sh attach --follow-seconds 300
+./workerctl.sh watch --follow-seconds 300
+./workerctl.sh stop --timeout 120 --json
+docker compose down
+```
+
+PowerShell:
+
+```powershell
+docker compose up -d
+.\workerctl.ps1 status
+.\workerctl.ps1 attach --follow-seconds 300
+.\workerctl.ps1 watch --follow-seconds 300
+.\workerctl.ps1 stop --timeout 120 --json
+docker compose down
+```
+
+`q` или `Ctrl-C` отсоединяет `attach`/`watch`, но не останавливает worker.
+`docker compose down` без `--volumes` сохраняет identity, token, незавершённую
+работу и history в `truf-worker-data`.
+
+## Диагностика
+
+```sh
+./workerctl.sh status --json
+./workerctl.sh logs --tail 200
+./workerctl.sh logs --follow --follow-seconds 300
+./workerctl.sh history --limit 50
+./workerctl.sh doctor --json
+```
+
+Не используйте `docker compose down --volumes`. Clean stop должен вернуть
+`state: stopped`, `drained: true`, `exit_code: 0`; только после этого выполняйте
+`docker compose down`.