The Riak Go Client is a client which makes it easy to communicate with Riak, an open source, distributed database that focuses on high availability, horizontal scalability, and predictable latency. Both Riak and this code is maintained by Basho.
The latest version of the client supports both Riak KV 2.0+, and Riak TS 1.0+.
go get github.com/basho/riak-go-client
This repository's maintainers are engineers at Basho and we welcome your contribution to the project! Review the details in CONTRIBUTING.md in order to give back to this project.
Note: Please clone this repository in such a manner that submodules are also cloned:
git clone --recursive https://github.com/basho/riak-go-client
OR:
git clone https://github.com/basho/riak-go-client
git submodule init --update
make unit-test
You have two options to run Riak locally - either build from source, or use a pre-installed Riak package.
To setup the default test configuration, build a Riak node from a clone of github.com/basho/riak
:
# check out latest release tag
git checkout riak-2.1.4
make locked-deps
make rel
When building from source, the protocol buffers port will be 8087
and HTTP will be 8098
.
Install using your platform's package manager (docs)
When installing from a package, the protocol buffers port will be 8087
and HTTP will be 8098
.
- Ensure you've initialized this repo's submodules:
git submodule update --init
- Run the following:
./tools/setup-riak
make integration-test
This repository's maintainers are engineers at Basho and we welcome your contribution to the project! Review the details in CONTRIBUTING.md in order to give back to this project.
Due to our obsession with stability and our rich ecosystem of users, community updates on this repo may take a little longer to review.
The most helpful way to contribute is by reporting your experience through issues. Issues may not be updated while we review internally, but they're still incredibly appreciated.
Thank you for being part of the community! We love you for it.
- 1.0.0 - Full Riak 2 support with command queuing and retries.
The Riak Go Client is Open Source software released under the Apache 2.0 License. Please see the LICENSE file for full license details.
These excellent community projects inspired this client and parts of their code
are in riak-go-client
as well:
Thank you to all of our contributors!