anti/DECNET
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(swarm): added

anti
2026-04-19 00:23:25 -04:00
parent e473159ea1
commit 201023ed17
1 changed files with 27 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
SWARM-Mode.md

@@ -240,6 +240,10 @@ decnet swarm enroll \
--out-dir /tmp/decky-vm-bundle --out-dir /tmp/decky-vm-bundle
``` ```
Add `--updater` to also issue a second bundle for the remote-update
daemon (see [Remote-Updates](Remote-Updates)); the updater bundle lands
in `/tmp/decky-vm-bundle-updater/`.
`--name` is the worker's DECNET identity — it becomes the cert CN and the `--name` is the worker's DECNET identity — it becomes the cert CN and the
`source_worker` tag on every log line forwarded from that host. Pick names `source_worker` tag on every log line forwarded from that host. Pick names
you can grep for. Must be unique; re-enrolling the same name is rejected. you can grep for. Must be unique; re-enrolling the same name is rejected.
@@ -441,6 +445,21 @@ Synchronously polls every active/enrolled agent's `/health`. On success,
flips status to `active` and stamps `last_heartbeat`. On failure, flips to flips status to `active` and stamps `last_heartbeat`. On failure, flips to
`unreachable` and records the error. `unreachable` and records the error.
### `decnet swarm deckies`
Lists every deployed decky across the swarm, joined with its owning worker
host's identity. `swarm list` answers *which workers are enrolled*; this
answers *which deckies are running and where*.
```
--host <name|uuid> Filter to a single worker (name is looked up → uuid).
--state <state> Filter by shard state: pending | running | failed | torn_down.
--json Emit JSON, not a table.
```
Columns: `decky`, `host`, `address`, `state`, `services`. State is colored
(green=running, red=failed, yellow=pending, dim=torn_down).
### `decnet swarm decommission` ### `decnet swarm decommission`
Marks a host `decommissioned` in the repo, tears down any running deckies Marks a host `decommissioned` in the repo, tears down any running deckies
@@ -506,6 +525,14 @@ cannot impersonate another worker's name.
## Operational concerns ## Operational concerns
### Pushing code updates without SSH
Once enrolled with `--updater`, the master can push new code to workers
over mTLS — no more `scp`/`sshpass` cycles. See
[Remote-Updates](Remote-Updates) for the `decnet swarm update` command,
auto-rollback semantics, and the `--include-self` opt-in for upgrading
the updater itself.
### Master crash / restart ### Master crash / restart
Kill the listener mid-shipment. The forwarder detects the dropped Kill the listener mid-shipment. The forwarder detects the dropped