feat: implement mini raftkv

Author: juanjuandog

.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+    branches: ["**"]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Go
+        uses: actions/setup-go@v6
+        with:
+          go-version-file: go.mod
+          cache: true
+
+      - name: Verify generated protobuf code
+        run: |
+          go install github.com/bufbuild/buf/cmd/buf@latest
+          go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
+          go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
+          make proto
+          git diff --exit-code
+
+      - name: Test
+        run: go test ./...
+
+      - name: Build binaries
+        run: make build

.gitignore

@@ -0,0 +1,8 @@
+bin/
+data/
+logs/
+/raftkv
+/raftkvctl
+*.db
+*.db.lock
+.DS_Store

Dockerfile

@@ -0,0 +1,17 @@
+FROM golang:1.26-alpine AS build
+
+WORKDIR /src
+COPY go.mod go.sum ./
+RUN go mod download
+COPY . .
+RUN go build -o /out/raftkv ./cmd/raftkv
+RUN go build -o /out/raftkvctl ./cmd/raftkvctl
+
+FROM alpine:3.22
+
+WORKDIR /app
+COPY --from=build /out/raftkv /usr/local/bin/raftkv
+COPY --from=build /out/raftkvctl /usr/local/bin/raftkvctl
+COPY configs ./configs
+
+ENTRYPOINT ["raftkv"]

Makefile

@@ -0,0 +1,38 @@
+.PHONY: proto test build run-n1 run-n2 run-n3 run-cluster demo bench clean docker-up docker-down
+
+proto:
+	$$(go env GOPATH)/bin/buf generate api --template buf.gen.yaml
+
+test:
+	go test ./...
+
+build:
+	go build -o bin/raftkv ./cmd/raftkv
+	go build -o bin/raftkvctl ./cmd/raftkvctl
+
+run-n1:
+	go run ./cmd/raftkv -config configs/n1.yaml
+
+run-n2:
+	go run ./cmd/raftkv -config configs/n2.yaml
+
+run-n3:
+	go run ./cmd/raftkv -config configs/n3.yaml
+
+run-cluster:
+	scripts/run-local-cluster.sh
+
+demo:
+	scripts/demo-flow.sh
+
+bench:
+	scripts/bench.sh
+
+docker-up:
+	docker compose up --build
+
+docker-down:
+	docker compose down -v
+
+clean:
+	rm -rf bin data