FV-1, FV-13: Raft prevLogIndex/prevLogTerm + CI fix
- raft.tla: Add HasCompatiblePrefix check (prevLogIndex/prevLogTerm) - raft.tla: Add RejectAppendEntries action for follower rejection - raft.tla: Add conflict truncation + commitIndex/matchIndex adjustment - raft.tla: Restore LogMatching invariant - raft.tla: Guard AppendEntry to prevent term gaps in leader log - models/raft.cfg: Add LogMatching to checked invariants - .github/workflows/ci.yml: Replace container with setup-java + cache - run_all.sh: Use -workers auto and -XX:+UseParallelGC - Update PLAN.md, PLAN_DONE.md, ANALYSIS.md, README.md
This commit is contained in:
@@ -72,7 +72,7 @@
|
||||
|
||||
Спрямо реалната имплементация (`raft.nim`, 564 реда), моделът пропуска:
|
||||
|
||||
- **PrevLogIndex/PrevLogTerm проверка** — Replicate действието не валидира, че follower има съвместим префикс. Това прави `LogMatching` инварианта неизпълним (затова беше премахнат).
|
||||
- ~~**PrevLogIndex/PrevLogTerm проверка**~~ ✅ Направено — `Replicate` вече изисква `HasCompatiblePrefix`, добавено е `RejectAppendEntries`, и `LogMatching` инвариантата е възстановена.
|
||||
- **Log truncation/compaction** — Няма snapshot механизъм.
|
||||
- **Membership changes** — Няма добавяне/премахване на възли.
|
||||
- **Leader step-down при partition** — Няма leader lease или heartbeat fail.
|
||||
|
||||
@@ -21,6 +21,19 @@ This directory contains TLA+ specifications for core BaraDB distributed-systems
|
||||
- Java Runtime Environment (JRE) 8+ — the bundled `tla2tools.jar` contains TLC and SANY.
|
||||
- Or [TLA+ Toolbox](https://lamport.azurewebsites.net/tla/toolbox.html) (GUI + TLC model checker).
|
||||
|
||||
## Verified State Space (v1.1.0)
|
||||
|
||||
| Spec | States Generated | Distinct States | Depth |
|
||||
|------|-----------------|-----------------|-------|
|
||||
| raft.tla | 3,031,684 | 833,024 | 47 |
|
||||
| twopc.tla | 2,125,825 | 262,144 | 28 |
|
||||
| mvcc.tla | 177,849 | 59,860 | 13 |
|
||||
| replication.tla | 3,687,939 | 490,560 | 22 |
|
||||
| gossip.tla | 1,257,121 | 110,592 | 28 |
|
||||
| deadlock.tla | 3,767,361 | 263,950 | 9 |
|
||||
| sharding.tla | 186,305 | 23,296 | 11 |
|
||||
| **Total** | **14,234,084** | **2,043,426** | — |
|
||||
|
||||
## Running the Model Checker
|
||||
|
||||
### All specs at once
|
||||
@@ -59,6 +72,7 @@ java -cp tla2tools.jar tlc2.TLC -config models/sharding.cfg sharding.tla
|
||||
- `LeaderAppendOnly` — a leader never produces invalid log entries.
|
||||
- `StateMachineSafety` — if a node has committed a log entry at a given index, no other node has a different entry for the same index.
|
||||
- `CommittedIndexValid` — commitIndex never exceeds the node's log length.
|
||||
- `LogMatching` — if two logs contain an entry with the same index and term, all preceding entries are identical.
|
||||
|
||||
### twopc.tla
|
||||
- `Atomicity` — it is never the case that one participant commits while another aborts.
|
||||
|
||||
@@ -15,3 +15,4 @@ INVARIANTS
|
||||
LeaderAppendOnly
|
||||
StateMachineSafety
|
||||
CommittedIndexValid
|
||||
LogMatching
|
||||
|
||||
@@ -8,6 +8,8 @@
|
||||
- LeaderAppendOnly : leaders produce valid log entries.
|
||||
- StateMachineSafety : committed entries are identical on all nodes.
|
||||
- CommittedIndexValid : commitIndex never exceeds log length.
|
||||
- LogMatching : if two logs have an entry with same index and term,
|
||||
all preceding entries are identical.
|
||||
*)
|
||||
|
||||
EXTENDS Integers, Sequences, FiniteSets, TLC
|
||||
@@ -47,6 +49,16 @@ IsLeader(i, t) == state[i] = "Leader" /\ currentTerm[i] = t
|
||||
\* The set of all log entries up to index len on node i
|
||||
LogPrefix(i, len) == [j \in 1..len |-> log[i][j]]
|
||||
|
||||
\* Does follower j have a compatible log prefix up to (but not including) index idx?
|
||||
\* This implements the prevLogIndex/prevLogTerm check from handleAppendEntries.
|
||||
HasCompatiblePrefix(j, i, idx) ==
|
||||
\* idx = 1 means the leader is sending the very first entry — always compatible.
|
||||
IF idx = 1
|
||||
THEN TRUE
|
||||
ELSE IF Len(log[j]) < idx - 1 \/ Len(log[i]) < idx - 1
|
||||
THEN FALSE
|
||||
ELSE log[j][idx - 1][1] = log[i][idx - 1][1]
|
||||
|
||||
-----------------------------------------------------------------------------
|
||||
\* Initial state
|
||||
|
||||
@@ -95,24 +107,51 @@ BecomeLeader(i) ==
|
||||
/\ UNCHANGED <<currentTerm, votedFor, log, commitIndex, votesGranted>>
|
||||
|
||||
\* Leader i appends a new entry to its own log.
|
||||
\* Requires the last existing entry (if any) to match currentTerm so that
|
||||
\* the leader never creates a log with a gap in terms.
|
||||
AppendEntry(i) ==
|
||||
/\ state[i] = "Leader"
|
||||
/\ Len(log[i]) < MaxLogLen
|
||||
/\ IF Len(log[i]) = 0
|
||||
THEN TRUE
|
||||
ELSE log[i][Len(log[i])][1] = currentTerm[i]
|
||||
/\ log' = [log EXCEPT ![i] = Append(@, <<currentTerm[i], "cmd">>)]
|
||||
/\ UNCHANGED <<state, currentTerm, votedFor, commitIndex, votesGranted, nextIndex, matchIndex>>
|
||||
|
||||
\* Leader i replicates its log to follower j.
|
||||
\* Now includes prevLogIndex/prevLogTerm check and conflict truncation.
|
||||
Replicate(i, j) ==
|
||||
/\ i /= j
|
||||
/\ state[i] = "Leader"
|
||||
/\ nextIndex[i][j] <= Len(log[i])
|
||||
/\ log' = [log EXCEPT ![j] =
|
||||
IF Len(log[j]) >= nextIndex[i][j]
|
||||
THEN [log[j] EXCEPT ![nextIndex[i][j]] = log[i][nextIndex[i][j]]]
|
||||
ELSE Append(log[j], log[i][nextIndex[i][j]])]
|
||||
/\ HasCompatiblePrefix(j, i, nextIndex[i][j])
|
||||
/\ LET leaderEntry == log[i][nextIndex[i][j]]
|
||||
idx == nextIndex[i][j]
|
||||
\* If follower already has an entry at idx with a different term, truncate.
|
||||
conflict == idx <= Len(log[j]) /\ log[j][idx][1] /= leaderEntry[1]
|
||||
newLog == IF conflict
|
||||
THEN IF idx = 1
|
||||
THEN << >>
|
||||
ELSE SubSeq(log[j], 1, idx - 1)
|
||||
ELSE IF Len(log[j]) >= idx
|
||||
THEN [log[j] EXCEPT ![idx] = leaderEntry]
|
||||
ELSE Append(log[j], leaderEntry)
|
||||
newCommit == IF conflict THEN Min(commitIndex[j], idx - 1) ELSE commitIndex[j]
|
||||
newMatch == IF conflict THEN idx - 1 ELSE nextIndex[i][j]
|
||||
IN /\ log' = [log EXCEPT ![j] = newLog]
|
||||
/\ commitIndex' = [commitIndex EXCEPT ![j] = newCommit]
|
||||
/\ matchIndex' = [matchIndex EXCEPT ![i][j] = newMatch]
|
||||
/\ nextIndex' = [nextIndex EXCEPT ![i][j] = @ + 1]
|
||||
/\ matchIndex' = [matchIndex EXCEPT ![i][j] = nextIndex[i][j]]
|
||||
/\ UNCHANGED <<state, currentTerm, votedFor, commitIndex, votesGranted>>
|
||||
/\ UNCHANGED <<state, currentTerm, votedFor, votesGranted>>
|
||||
|
||||
\* Follower j rejects an AppendEntries from leader i because of prevLog mismatch.
|
||||
RejectAppendEntries(i, j) ==
|
||||
/\ i /= j
|
||||
/\ state[i] = "Leader"
|
||||
/\ nextIndex[i][j] > 1
|
||||
/\ ~HasCompatiblePrefix(j, i, nextIndex[i][j])
|
||||
/\ nextIndex' = [nextIndex EXCEPT ![i][j] = @ - 1]
|
||||
/\ UNCHANGED <<state, currentTerm, votedFor, log, commitIndex, votesGranted, matchIndex>>
|
||||
|
||||
\* Leader i updates commitIndex when a majority has replicated an entry.
|
||||
Commit(i) ==
|
||||
@@ -144,6 +183,7 @@ Next ==
|
||||
\/ \E i \in Nodes : BecomeLeader(i)
|
||||
\/ \E i \in Nodes : AppendEntry(i)
|
||||
\/ \E i, j \in Nodes : Replicate(i, j)
|
||||
\/ \E i, j \in Nodes : RejectAppendEntries(i, j)
|
||||
\/ \E i \in Nodes : Commit(i)
|
||||
\/ \E i \in Nodes : \E t \in 2..MaxTerm : StepDown(i, t)
|
||||
|
||||
@@ -171,6 +211,14 @@ StateMachineSafety ==
|
||||
CommittedIndexValid ==
|
||||
\A i \in Nodes : commitIndex[i] <= Len(log[i])
|
||||
|
||||
\* Log Matching property: if two logs contain an entry with the same index and term,
|
||||
\* then the logs are identical in all preceding entries.
|
||||
LogMatching ==
|
||||
\A i, j \in Nodes :
|
||||
\A idx \in 1..Min(Len(log[i]), Len(log[j])) :
|
||||
log[i][idx] = log[j][idx] =>
|
||||
\A k \in 1..idx : log[i][k] = log[j][k]
|
||||
|
||||
\* Type invariant
|
||||
TypeOk ==
|
||||
/\ state \in [Nodes -> {"Follower", "Candidate", "Leader"}]
|
||||
|
||||
@@ -17,12 +17,12 @@ run_tlc() {
|
||||
echo "=============================================="
|
||||
echo " TLC: $spec (cfg: $cfg)"
|
||||
echo "=============================================="
|
||||
java -cp "$JAR" tlc2.TLC -config "$cfg" "$spec" 2>&1 | tail -5
|
||||
java -XX:+UseParallelGC -cp "$JAR" tlc2.TLC -workers auto -config "$cfg" "$spec" 2>&1 | tail -5
|
||||
echo ""
|
||||
}
|
||||
|
||||
echo "=============================================="
|
||||
echo " BaraDB Formal Verification Suite v1.0.0"
|
||||
echo " BaraDB Formal Verification Suite v1.1.0"
|
||||
echo " Running TLC model checker on all specs"
|
||||
echo "=============================================="
|
||||
echo ""
|
||||
|
||||
Reference in New Issue
Block a user