{"id":21213695,"url":"https://github.com/chuyangliu/rawkv","last_synced_at":"2025-07-10T09:33:03.340Z","repository":{"id":57531465,"uuid":"261521511","full_name":"chuyangliu/rawkv","owner":"chuyangliu","description":"Cloud-native distributed key-value database.","archived":false,"fork":false,"pushed_at":"2025-02-28T18:09:17.000Z","size":191,"stargazers_count":11,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-05T12:42:00.108Z","etag":null,"topics":["cloud-native","consensus","database","distributed-systems","docker","golang","grpc","key-value","kubernetes","log-structured","raft","replication","transaction"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chuyangliu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-05T16:11:39.000Z","updated_at":"2025-02-28T18:09:21.000Z","dependencies_parsed_at":"2025-02-28T19:22:07.631Z","dependency_job_id":"22fcca24-825e-40fa-adb8-81fecc295265","html_url":"https://github.com/chuyangliu/rawkv","commit_stats":{"total_commits":117,"total_committers":1,"mean_commits":117.0,"dds":0.0,"last_synced_commit":"154f892f16bdf3ee9a8ccf8fd8d1b6193d5610ed"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/chuyangliu/rawkv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chuyangliu%2Frawkv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chuyangliu%2Frawkv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chuyangliu%2Frawkv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chuyangliu%2Frawkv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chuyangliu","download_url":"https://codeload.github.com/chuyangliu/rawkv/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chuyangliu%2Frawkv/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264559289,"owners_count":23628037,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud-native","consensus","database","distributed-systems","docker","golang","grpc","key-value","kubernetes","log-structured","raft","replication","transaction"],"created_at":"2024-11-20T21:17:39.757Z","updated_at":"2025-07-10T09:33:03.089Z","avatar_url":"https://github.com/chuyangliu.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RawKV\n\n[![][goreport-badge]][goreport] [![][godoc-badge]][godoc]\n\nRawKV is a cloud-native distributed key-value database aiming to run on Kubernetes clusters, with focuses on:\n\n- Arbitrary raw bytes as keys and values\n- Write-optimized storage engine based on log-structured merge-tree\n- Reliable data replication with Raft consensus algorithm\n- Favor availability over consistency in the presence of network partitions\n\n## Installation\n\n### Build\n\nPass unit tests:\n\n```\ngo test ./pkg/...\n```\n\nInstall RawKV client:\n\n```\ngo install ./pkg/cmd/rawkvcli\n```\n\nBuild docker image of RawKV server:\n\n```\ndocker build -t rawkvsvr:latest .\n```\n\n### Deploy\n\nRawKV requires a running Kubernetes cluster to function. Once the cluster has been established, start deployment:\n\n```\nkubectl apply -f rawkv.yaml\n```\n\nGet exposed port number of RawKV load balancer specified under `service/rawkv-lb`:\n\n```\nkubectl get -f rawkv.yaml\n```\n\nUse RawKV client `rawkvcli` to send requests to the load balancer:\n\n```\n$GOPATH/bin/rawkvcli put -addr 127.0.0.1:\u003cport\u003e -key name -val rawkv\n$GOPATH/bin/rawkvcli get -addr 127.0.0.1:\u003cport\u003e -key name\n$GOPATH/bin/rawkvcli del -addr 127.0.0.1:\u003cport\u003e -key name\n```\n\nStop services and clean up:\n\n```\nkubectl delete -f rawkv.yaml\nkubectl delete pvc -l app=rawkv\n```\n\n### Debug\n\nBy default, [`rawkv.yaml`](./rawkv.yaml) creates three RawKV replicas:\n\n```\nkubectl get pods -l app=rawkv\n```\n\nView logs emitted from a replica (index starts with 0):\n\n```\nkubectl logs -f rawkv-\u003cindex\u003e\n```\n\nDelete a replica to simulate node crash:\n\n```\nkubectl delete pod rawkv-\u003cindex\u003e\n```\n\n## License\n\nSee the [LICENSE](./LICENSE) file for license rights and limitations.\n\n[goreport]: https://goreportcard.com/report/github.com/chuyangliu/rawkv\n[goreport-badge]: https://goreportcard.com/badge/github.com/chuyangliu/rawkv\n\n[godoc]: https://pkg.go.dev/mod/github.com/chuyangliu/rawkv\n[godoc-badge]: https://img.shields.io/badge/godoc-reference-blue\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchuyangliu%2Frawkv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchuyangliu%2Frawkv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchuyangliu%2Frawkv/lists"}