diff options
| author | tv <tv@krebsco.de> | 2026-11-16 19:54:35 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-16 21:26:18 +0100 |
| commit | c9707297bd393f69461c781a38a5ddb017dced60 (patch) | |
| tree | bd4bf940103b7f6bc583ef13ba27c9b4eec76c7a /docs | |
| parent | 3ee3816076d07b0e9b2c56cc7ea6e50951745027 (diff) | |
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.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/example.toml | 6 | ||||
| -rw-r--r-- | docs/openapi.yaml | 4 |
2 files changed, 8 insertions, 2 deletions
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 <base64> [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 diff --git a/docs/openapi.yaml b/docs/openapi.yaml index bfb5ba3..0f1af33 100644 --- a/docs/openapi.yaml +++ b/docs/openapi.yaml @@ -2802,8 +2802,8 @@ components: description: | This node's own files, by kind (`state`: the state file, `document`: the document file, `backup`: a backup recovered from, `remake`: the input of a - genesis remake, and behind the `federation` feature `store`: a store's root), - since it started. + genesis remake, and behind the `federation` feature `store`: a store's root, + and what the node keeps of its own of its store), since it started. additionalProperties: type: object required: [reads, readBytes, writes, writtenBytes, appends, appendedBytes, errors] |
