@taskless-app/swarm 0.4.1 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -34,6 +34,35 @@ swarm --help # список остальных коман
34
34
 
35
35
  Полный гайд по настройке и запуску роя — на [taskless.ru](https://taskless.ru).
36
36
 
37
+ ## Остановить, приостановить, отключить машину
38
+
39
+ Гасить демона по имени процесса (`pkill -f overmind`) не нужно — есть штатные команды:
40
+
41
+ ```bash
42
+ swarm status # жив ли демон, на паузе ли рой, сколько дронов в работе
43
+ swarm pause «причина» # не брать НОВУЮ работу; живые дроны доработают
44
+ swarm resume # снова брать работу
45
+ swarm stop # погасить демона на этой машине
46
+ swarm remove --yes # отключить машину от роя целиком
47
+ ```
48
+
49
+ **`swarm stop` по умолчанию не обрывает дронов.** Есть живые сессии — команда
50
+ покажет, кто работает, и не станет их убивать: незапушенная работа дрона умирает
51
+ вместе с ним. Дальше выбираете сами: `swarm stop --wait` (дождаться, новую работу
52
+ рой в это время не берёт) или `swarm stop --force` (погасить сейчас, оборвав их).
53
+
54
+ **Пауза переживает перезапуск.** Она лежит файлом `~/.taskless-swarm/pause.json`,
55
+ поэтому перезагрузка машины не возвращает рой к работе молча. Поставить её можно и
56
+ при лежащем демоне — тогда следующий `swarm start` поднимется уже на паузе. Пауза,
57
+ поставленная из интерфейса Taskless, снимается командой на машине и наоборот:
58
+ состояние одно, и оно же видно в парке машин («на паузе» — не то же самое, что
59
+ «молчит» или «нет работы»).
60
+
61
+ **`swarm remove` ≠ `swarm logout`.** `logout` забывает токены на этой машине
62
+ (перелогиниться); `remove` выводит машину из роя: гасит демона, убирает её из парка
63
+ машин (её незавершённые прогоны освобождаются и уедут на другие машины) и стирает
64
+ токены. Вернуть — `swarm login && swarm start`.
65
+
37
66
  ## Windows
38
67
 
39
68
  Рой работает на Windows, но **рекомендуемый способ — WSL2**: там он ведёт себя ровно