https://github.com/kochava/docker-riak

Docker image for the Riak database.
https://github.com/kochava/docker-riak

db docker riak riak-kv tf

Last synced: 3 months ago
JSON representation

Docker image for the Riak database.

Host: GitHub
URL: https://github.com/kochava/docker-riak
Owner: Kochava
License: apache-2.0
Created: 2019-11-05T21:08:52.000Z (almost 6 years ago)
Default Branch: main
Last Pushed: 2021-08-04T15:31:35.000Z (about 4 years ago)
Last Synced: 2025-02-25T04:22:31.096Z (8 months ago)
Topics: db, docker, riak, riak-kv, tf
Language: Dockerfile
Homepage:
Size: 58.6 KB
Stars: 1
Watchers: 4
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# docker-riak

This repository contains a Dockerfile that will build Riak into a Ubuntu 16.04
Xenial image, starting a Riak server.

Building
--------

To build the Docker image, run `make` (or `make docker`). The build can take
some time, as it involves building both Erlang and Riak from source.

You can alter the resulting image with the following Makefile variables:

Starting Riak
-------------

To start Riak, you can create a simple container with `docker run`:

```
# Create a network:
$ docker network create riak

# Start node riak-1:
$ docker run --detach --network riak --env RIAK_NODENAME=riak@riak-1. --name riak-1 kochava/riak
```

To then start a second node and join it to the cluster, you would do the
following:

```
# Start node riak-2:
$ docker run --detach --network riak --env RIAK_NODENAME=riak@riak-2. --name riak-2 kochava/riak

# Join the cluster:
$ docker exec -it riak-2 riak-admin cluster join riak@riak-1.

# Check the cluster plan:
$ docker exec -it riak-2 riak-admin cluster plan

# Commit the cluster plan:
$ docker exec -it riak-2 riak-admin cluster commit

# Check riak-1's memberships:
$ docker exec -it riak-1 riak-admin status | grep ring_members
ring_members : ['riak@riak-1.','riak@riak-2.']
```

Configuration
-------------

### riak.conf

The riak.conf can be modified in two ways:

1. Mount a riak.conf as `/usr/local/riak/etc/riak.conf`.

2. Set `RIAK_` environment variables, which will be appended to the riak.conf
in the container. If you've mounted a riak.conf into the container, avoid
using `RIAK_` variables, since this could modify the file that was mounted.

The variables and the config key they correspond to are listed in a table
below.

### advanced.conf

If modifying advanced.conf, you must mount it into the container or build
a derived image from it. There is currently no option to configure its options
via environment variables.

### Cluster Operations

Riak's bin dir is in the container's PATH. You can run `riak-admin`, `riak`, and
other commands using `docker exec`. Note that running `riak stop` will stop
Riak, but that runsv will start it afterward.

### Stopping the Container

Because the container uses `runsv`, if you start it in interactive mode,
a Ctrl-C will send an interrupt signal to runsv, which will
diligently send it to Riak.

Instead, you need to either send a terminate signal to runsv or use `docker stop
$CONTAINER` (which will send a terminate signal for you). You can also use
`docker exec $CONTAINER sv x`, which will also instruct runsv to exit.

### RIAK\_\* Environment Variables

The following environment variables, if set, will modify riak.conf by setting
the associated riak.conf field to its value. Exercise caution when using this
with bind-mounted riak.conf files, as it will append lines to the file.

License
-------

All files under this repository are licensed under the Apache License Version
2.0.

Exceptions are made for riak.conf and advanced.config, which are under the same
license, but are copyright 2013 Basho Technologies, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

## Default Branch

As of October 1, 2020, github.com uses the branch name ‘main’ when creating the initial default branch for all new repositories. In order to minimize any customizations in our github usage and to support consistent naming conventions, we have made the decision to rename the ‘master’ branch to be called ‘main’ in all Kochava’s github repos.

For local copies of the repo, the following steps will update to the new default branch:

```
git branch -m master main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a
```

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/kochava/docker-riak

Awesome Lists containing this project

README