truf-server/docs/remote-worker-cheatsheet-docker-ru.md

TRUF worker: шпаргалка Docker

Откройте Bash или PowerShell в корне bundle с compose.yaml, worker image archive и helper scripts. Нужен Docker Engine с Compose v2 либо Docker Desktop.

Один раз

Создайте локальный worker-install.yaml через текстовый редактор:

server: https://pregnant.horsecock.store
token: PASTE_DEVICE_TOKEN_HERE
parallelism: 1

Bash:

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:

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:

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:

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.

Диагностика

./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.