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 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.
# 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
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
Backrunner source contains Dockerfile, you can build own Docker images
# cd backrunner # docker build .
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