从etcd学习raft

最新推荐文章于 2025-08-23 19:36:46 发布

原创

最新推荐文章于 2025-08-23 19:36:46 发布 · 735 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#etcd #学习 #数据库

在etcd的项目下有一个使用raft的示例，在之前读etcd代码的时候会比较难理解raft相关的代码。因此通过这个示例会更容易的了解raft相关的实现细节。

我将这部分代码推送到了我的git仓库：https://github.com/yugu2day/raftexample

在示例中，主要是构建了一个基于map的k-v存储服务，支持PUT 和 GET 对键值内容的存取，通过POST 和 DELETE 来添加/删除raft集群中的节点。

如何使用示例

可以按照代码中的README在本地启动这个简单的示例，这里也大概描述一下过程。在构建出可执行文件并通过启动参数设置节点ID，服务端口之后，就可以通过HTTP请求进行键值对的更新查询。可以从下面的输出看到在启动之后会有一些日志打印出来，我们启动的节点id是1，在日志中就包括member1 在不同的term中的角色切换。

go build -o raftexample
./raftexample --id 1 --cluster http://127.0.0.1:12379 --port 12380

2024/08/26 16:07:28 replaying WAL of member 1
2024/08/26 16:07:28 loading WAL at term 0 and index 0
raft2024/08/26 16:07:28 INFO: 1 switched to configuration voters=()
raft2024/08/26 16:07:28 INFO: 1 became follower at term 0
raft2024/08/26 16:07:28 INFO: newRaft 1 [peers: [], term: 0, commit: 0, applied: 0, lastindex: 0, lastterm: 0]
raft2024/08/26 16:07:28 INFO: 1 became follower at term 1
raft2024/08/26 16:07:28 INFO: 1 switched to configuration voters=(1)
raft2024/08/26 16:07:28 INFO: 1 switched to configuration voters=(1)
raft2024/08/26 16:07:29 INFO: 1 is starting a new election at term 1
raft2024/08/26 16:07:29 INFO: 1 became candidate at term 2
raft2024/08/26 16:07:29 INFO: 1 received MsgVoteResp from 1 at term 2
raft2024/08/26 16:07:29 INFO: 1 became leader at term 2
raft2024/08/26 16:07:29 INFO: raft.node: 1 elected leader 1 at term 2

通过http请求启动的服务，可以看到现在GET 和 PUT 请求是能够正常的获取和更新键值对的内容的。

curl -L http://127.0.0.1:12380/my-key -XPUT -d hello
curl -L http://127.0.0.1:12380/my-key
hello%
curl -L http://127.0.0.1:12380/my-key -XPUT -d hello11
hello11%

raftnode 的启动

在main函数中，会根据我们的启动参数构建对应的raftnode，后续raft相关消息的传递都是由raftnode完成。

func main() {
   
   
        ...
    getSnapshot := func() ([]byte, error) {
   
    return kvs.getSnapshot() }
    commitC, errorC, snapshotterReady := newRaftNode(*id, strings.Split(*cluster, ","), *join, getSnapshot, proposeC, confChangeC)
        ...
}

func newRaftNode(id int, peers []string, join bool, getSnapshot func() ([]byte, error), proposeC <-chan string,
	confChangeC <-chan raftpb.ConfChange) (<-chan *commit,