# KVstorageBaseRaft-cpp **Repository Path**: ornamrr/KVstorageBaseRaft-cpp ## Basic Information - **Project Name**: KVstorageBaseRaft-cpp - **Description**: No description available - **Primary Language**: C++ - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2024-01-25 - **Last Updated**: 2024-02-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # KVstorageBaseRaft-cpp [【代码随想录知识星球】](https://programmercarl.com/other/kstar.html)项目分享-基于Raft的k-v存储数据库，[项目专栏](https://t.zsxq.com/16jOQtIDb) 有本项目的详细文档 > notice：本项目的目的是学习Raft的原理，并实现一个简单的k-v存储数据库。因此并不适用于生产环境。 ## 分支说明 - main：最新内容，已经实现一个简单的clerk - rpc：基于muduo和rpc框架相关内容 - raft_DB：基于Raft的k-v存储数据库，主要用于观察选举过程 ## 使用方法 ### 1.库准备 - muduo - boost - protoc > 如果库安装编译本仓库的时候有错误，可以参考这个issue：https://github.com/youngyangyang04/KVstorageBaseRaft-cpp/issues/28 ### 2.编译启动 #### 使用rpc ``` mkdir cmake-build-debug cd cmake-build-debug cmake .. make ``` 之后在目录bin就有对应的可执行文件生成： - consumer - provider 运行即可，注意先运行provider，再运行consumer，原因很简单：需要先提供rpc服务，才能去调用。 #### 使用raft集群 ``` mkdir cmake-build-debug cd cmake-build-debug cmake.. make ``` 之后在目录bin就有对应的可执行文件生成， ``` // make sure you in bin directory ,and this has a test.conf file raftCoreRun -n 3 -f test.conf ``` 这里更推荐一键运行，使用clion/clion nova，点击这个按钮即可： ![img.png](images/img.png) 正常运行后，命令行应该有如下raft的运行输出： ``` 20231228 13:04:40.570744Z 615779 INFO TcpServer::newConnection [RpcProvider] - new connection [RpcProvider-127.0.1.1:16753#2] from 127.0.0.1:37234 - TcpServer.cc:80 [2023-12-28-21-4-41] [Init&ReInit] Sever 0, term 0, lastSnapshotIncludeIndex {0} , lastSnapshotIncludeTerm {0} [2023-12-28-21-4-41] [Init&ReInit] Sever 1, term 0, lastSnapshotIncludeIndex {0} , lastSnapshotIncludeTerm {0} [2023-12-28-21-4-41] [Init&ReInit] Sever 2, term 0, lastSnapshotIncludeIndex {0} , lastSnapshotIncludeTerm {0} [2023-12-28-21-4-41] [ ticker-func-rf(1) ] 选举定时器到期且不是leader，开始选举 [2023-12-28-21-4-41] [func-sendRequestVote rf{1}] 向server{1} 發送 RequestVote 開始 [2023-12-28-21-4-41] [func-sendRequestVote rf{1}] 向server{1} 發送 RequestVote 開始 [2023-12-28-21-4-41] [func-sendRequestVote rf{1}] 向server{1} 發送 RequestVote 完畢，耗時:{0} ms [2023-12-28-21-4-41] [func-sendRequestVote rf{1}] elect success ,current term:{1} ,lastLogIndex:{0} [2023-12-28-21-4-41] [func-sendRequestVote rf{1}] 向server{1} 發送 RequestVote 完畢，耗時:{0} ms [2023-12-28-21-4-41] [func-Raft::doHeartBeat()-Leader: {1}] Leader的心跳定时器触发了 [2023-12-28-21-4-41] [func-Raft::doHeartBeat()-Leader: {1}] Leader的心跳定时器触发了 index:{0} [2023-12-28-21-4-41] [func-Raft::doHeartBeat()-Leader: {1}] Leader的心跳定时器触发了 index:{2} [2023-12-28-21-4-41] [func-Raft::sendAppendEntries-raft{1}] leader 向节点{0}发送AE rpc開始 ， args->entries_size():{0} [2023-12-28-21-4-41] [func-Raft::sendAppendEntries-raft{1}] leader 向节点{2}发送AE rpc開始 ， args->entries_size():{0} [2023-12-28-21-4-41] [func-Raft::doHeartBeat()-Leader: {1}] Leader的心跳定时器触发了 ``` #### 使用kv 在启动raft集群之后启动`callerMain`即可。 ## Docs - 如果你想创建自己的rpc，请参考example中rpc的md文件和friendRPC相关代码.此外可以见rpc分支 > notice:在代码编写过程中可能有一些bug改进，其他分支可能并没有修复这些bug以及相应的改进。注意甄别 >同时欢迎issue提出这些bug或者pr改进。 ## 各个文件夹文件内容说明 todo ## todoList - [x] 完成raft节点的集群功能 - [ ] 去除冗余的库：muduo、boost - [ ] 代码精简优化 - [ ] code format - [ ] 代码解读 maybe ## Star History Star History Chart