raftd 分布式KV数据库教程

raftd 分布式KV数据库教程

raftdA reference implementation for using the go-raft library for distributed consensus.项目地址:https://gitcode.com/gh_mirrors/ra/raftd

项目介绍

raftd 是一个基于 Raft 共识算法和 Bolt 数据库的分布式键值（KV）存储系统。它通过简单的租约系统实现服务发现功能，并使用 Gin 框架提供 HTTP 服务接口。raftd 旨在提供一个易于部署和使用的分布式存储解决方案，适用于需要高可用性和数据一致性的场景。

项目快速启动

环境准备

确保你已经安装了 Go 语言环境（推荐版本 1.16 及以上）。

克隆项目

git clone https://github.com/goraft/raftd.git
cd raftd

构建项目

go build -o raftd cmd/raftd/main.go

启动节点

启动第一个节点：

./raftd -id node01 -haddr 127.0.0.1:8001 -raddr 127.0.0.1:8101

启动第二个节点并加入集群：

./raftd -id node02 -haddr 127.0.0.1:8002 -raddr 127.0.0.1:8102 -join 127.0.0.1:8001

启动第三个节点并加入集群：

./raftd -id node03 -haddr 127.0.0.1:8003 -raddr 127.0.0.1:8103 -join 127.0.0.1:8001

测试集群

插入数据：

curl -X PUT 127.0.0.1:8001/key/test -T test.png

获取数据：

curl 127.0.0.1:8001/key/test --output test.png

应用案例和最佳实践

服务发现

raftd 的租约系统可以用于服务发现。以下是一个简单的服务发现示例：

# 服务1
ID=$(curl -sL -XPOST 127.0.0.1:8001/lease/grant?ttl=10\&name=/esq/node-1)
while true; do
  curl -sL -XPOST 127.0.0.1:8001/lease/keepalive/$ID -d 'key=nodeinfo' -d 'data={"http_addr":"127.0.0.1:9001", "tcp_addr":"127.0.0.1:9002", "node_id":1, "weight":1}'
  sleep 3
done

# 服务2
ID=$(curl -sL -XPOST 127.0.0.1:8001/lease/grant?ttl=10\&name=/esq/node-2)
while true; do
  curl -sL -XPOST 127.0.0.1:8001/lease/keepalive/$ID -d 'key=nodeinfo1' -d 'data={"http_addr":"127.0.0.1:9003", "tcp_addr":"127.0.0.1:9004", "node_id":2, "weight":2}'
  sleep 3
done

数据一致性

在分布式系统中，数据一致性是关键。raftd 通过 Raft 算法确保所有节点间的数据一致性，适用于需要强一致性的应用场景。

典型生态项目

Gin 框架

raftd 使用 Gin 框架提供 HTTP 服务接口，Gin 是一个高性能的 Go 语言 Web 框架，适用于构建 RESTful API 和 Web 应用。

Bolt 数据库

Bolt 是一个嵌入式键值存储数据库，适用于需要高性能和简单 API 的应用场景。raftd 使用 Bolt 作为底层存储引擎，提供持久化存储功能。

Raft 共识算法

Raft 是一种用于管理复制日志的共识算法，旨在比

raftdA reference implementation for using the go-raft library for distributed consensus.项目地址:https://gitcode.com/gh_mirrors/ra/raftd