From c9707297bd393f69461c781a38a5ddb017dced60 Mon Sep 17 00:00:00 2001 From: tv Date: Mon, 16 Nov 2026 19:54:35 +0000 Subject: federation: the store read from the document A node of a swarm holding a store holds the store, read from its document (`docs/store.md`, What the store takes from the document): `federation::held`. Whenever the document changes, a worker reads the events it holds that the store wasn't offered from it, under the document's lock, and offers them to the store without it, each taken as from anywhere: once its dependencies are held, judged at its history. Another document (a drop, a rejoin) is read as it comes, the store going on. The node reads its store anew from its document whenever it starts, from the root, by what is its own of it: the events it refused by what it took before, and those its operator had it drop, which it keeps in a file (`--store-file`), written whenever that changes, so that a store read anew in another order refuses what it refused before. A file that doesn't read stops the node from starting; without one, a restart may take what it refused. --- docs/example.toml | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'docs/example.toml') diff --git a/docs/example.toml b/docs/example.toml index d7f8d08..c21158f 100644 --- a/docs/example.toml +++ b/docs/example.toml @@ -126,6 +126,12 @@ htpasswd = "/etc/continuum/htpasswd" # store-root = "/var/lib/continuum/root.json" # store-id = "…" +# Behind the `federation` feature, with store-root or store-id: where the node keeps +# what is its own of its store across restarts (the events it refused by what it took +# before, and those its operator had it drop). Without, a restart, reading the store +# anew from the document, may take what it refused. +# store-file = "/var/lib/continuum/store.json" + # SSH keys, as authorized_keys lines (ssh-ed25519 [comment]), whose signature # on a strict remake's manifest this node takes: the values kept when the swarm turns # strict (docs/access.md). Without, it votes for no strict remake; a majority of the -- cgit v1.3.1