Skip to content

Commit 4d0bb1f

Browse files
auricomclaude
andcommitted
docs(ha): absorb raft_production.md into ha/overview.md
raft_production.md had no sidebar entry and its content was fully superseded by the new ha/ guides. Extract the three pieces that were unique to it — bootstrap flag docs, auto-detection startup mode explanation, and static-membership limitation note — into ha/overview.md, then delete the file. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 409e218 commit 4d0bb1f

2 files changed

Lines changed: 22 additions & 103 deletions

File tree

docs/guides/ha/overview.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -153,10 +153,31 @@ raft:
153153

154154
A comma-separated list of the **other** cluster members (exclude the local node), in the format `nodeID@host:port`. The host and port must be the Raft address (`raft_addr`) of each peer as reachable from this node. Do not list the node's own `node_id` in its own `peers` field.
155155

156-
Raft uses this list to:
156+
Raft uses this list to:
157157
- Bootstrap the cluster on first start (when no persisted state exists).
158158
- Know which addresses to dial when sending log entries or heartbeats.
159159

160+
> **Limitation — static membership only.** Changing the peer set at runtime (adding or removing nodes without a full cluster restart) is not currently supported. All nodes that will ever participate in the cluster must be listed in `peers` before the cluster is first bootstrapped.
161+
162+
---
163+
164+
#### `raft.bootstrap`
165+
166+
```yaml
167+
raft:
168+
bootstrap: false
169+
```
170+
171+
**CLI:** `--evnode.raft.bootstrap`
172+
**Default:** `false`
173+
174+
Compatibility flag retained for older deployments. **You do not need to set this.** ev-node auto-detects the correct startup mode from the state of `raft_dir`:
175+
176+
- If `raft_dir` contains existing Raft state → the node **rejoins** the cluster automatically.
177+
- If `raft_dir` is empty or does not exist → the node **bootstraps** a new cluster from the `peers` list.
178+
179+
Setting `bootstrap: true` explicitly has no additional effect beyond what auto-detection already does.
180+
160181
---
161182

162183
### Timing Parameters

docs/guides/raft_production.md

Lines changed: 0 additions & 102 deletions
This file was deleted.

0 commit comments

Comments
 (0)