Reverbrain wiki

Site Tools


backrunner:installation

Backrunner installation

Backrunner is written in Go because of its natural parallelization. This tutorial will cover basic steps needed to build Backrunner from sources or installing it in Docker container.

We use Docker to distribute Backrunner images, you can find them at Docker Hub.

Building

We will not cover how to install Go language binary, here is an excellent Go guide: https://golang.org/doc/install

Building Backrunner from sources is as simple as

$ git clone http://github.com/bioothod/backrunner
$ cd backrunner
$ go build
$ go build meta/bmeta.go

bmeta tool is needed to setup buckets.

Installing from Docker Hub

# docker pull reverbrain/backrunner
# docker run -d -v /some/path/elliptics:/mnt/elliptics -p 80:80 -p 443:443 reverbrain/backrunner:latest /root/go/bin/backrunner -config /mnt/elliptics/etc/backrunner.conf -buckets /mnt/elliptics/etc/buckets.production

Where backrunner.conf is Backrunner config, and buckets.production is list of buckets, one per line, for example

$ cat buckets.production
b1
b2
b3
b4
b5
Building Docker image

Backrunner source contains Dockerfile, you can build own Docker images

# cd backrunner
# docker build .

Creating buckets

Bucket is an object which contains metadata about how replicas should be arranged. Bucket has a symbolic name like b123. Backrunner uses bucket names in URLs for simple mnemonics, but this object has a lot inside.

To create and upload buckets into Elliptics storage one should use bmeta tool built above. Bucket link above contains steps needed to upload new bucket into the storage: http://doc.reverbrain.com/backrunner:backrunner#bucket_upload

backrunner/installation.txt ยท Last modified: 2015/09/19 00:34 by zbr