vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Activity

docs: say that re-creating an undeclared agent leaves it paused

Browse source 
`swarmctl agent create` declares an agent the swarm has no declaration
for as paused, so ruth needs setting `up` from her card after step 4.
Restores the warning to re-create agents before a hive-side change makes
a container require a store identity.
This commit is contained in:
atlas 2026-10-13 01:17:42 +02:00 • committed by mara
commit ff0a6f1ca3
2 changed files with 14 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

10
docs/swarm/credentials.md
View file

@ -113,7 +113,15 @@ swarmctl agent mint-forge-token <agent>
An agent without a store identity gets no swarm token and keeps using the
`forge-token` file in its state dir, if it has one; re-create it with
`swarmctl agent create` to give it one.
`swarmctl agent create` to give it one. The swarm leaves an agent it already
declares as it is. For an agent with no declaration, such as one only its hive
knows about, `agent create` declares it `paused`; set it `up` from its card in
the swarm UI.
⚠️ **Re-create existing agents before deploying a hive-side change that makes a
container require a credential it may not have.** A container whose store
identity is absent doesn't start (`nix/agent-modules/bao.nix` exits 1), so
create the identities first, setting any newly paused agent `up` as above.
**Revoking an agent's queue credential.** Declaring an agent `destroyed` —
`PUT /api/hives/{hive}/agents/{agent}/state` — deletes