RawKV is a cloud-native distributed key-value database aiming to run on Kubernetes clusters, with focuses on:
- Arbitrary raw bytes as keys and values
- Write-optimized storage engine based on log-structured merge-tree
- Reliable data replication with Raft consensus algorithm
- Favor availability over consistency in the presence of network partitions
Pass unit tests:
go test ./pkg/...
Install RawKV client:
go install ./pkg/cmd/rawkvcli
Build docker image of RawKV server:
docker build -t rawkvsvr:latest .
RawKV requires a running Kubernetes cluster to function. Once the cluster has been established, start deployment:
kubectl apply -f rawkv.yaml
Get exposed port number of RawKV load balancer specified under service/rawkv-lb:
kubectl get -f rawkv.yaml
Use RawKV client rawkvcli to send requests to the load balancer:
$GOPATH/bin/rawkvcli put -addr 127.0.0.1:<port> -key name -val rawkv
$GOPATH/bin/rawkvcli get -addr 127.0.0.1:<port> -key name
$GOPATH/bin/rawkvcli del -addr 127.0.0.1:<port> -key name
Stop services and clean up:
kubectl delete -f rawkv.yaml
kubectl delete pvc -l app=rawkv
By default, rawkv.yaml creates three RawKV replicas:
kubectl get pods -l app=rawkv
View logs emitted from a replica (index starts with 0):
kubectl logs -f rawkv-<index>
Delete a replica to simulate node crash:
kubectl delete pod rawkv-<index>
See the LICENSE file for license rights and limitations.