puppet-rethinkdb's Introduction

puppet-rethinkdb

A Puppet module for RethinkDB.

Dependencies

stdlib
apt

Limitations

Only works under Ubuntu. Sorry.
Only supports a single instance per machine
You must specify a user/group for the service (leaving it blank is not an option)

Installation

Via puppet forge: http://forge.puppetlabs.com/tmont/rethinkdb
Via git submodule: git submodule add [email protected]:tmont/puppet-rethinkdb path/to/modules/rethinkdb

Usage

With all the defaults:

include rethinkdb

With custom parameters:

# these are the default values for each parameter
class { 'rethinkdb':
	rethinkdb_user => 'rethinkdb'
	rethinkdb_group => 'rethinkdb',
	instance_name => 'default',
	driver_port => 28015,
	http_port => 8080,
	cluster_port => 29015,
	rethinkdb_bind => 'all', #slightly dangerous, see below
	rethinkdb_join => undef #e.g. "mymachine:29015"
}

The above will generate the following conf file (in /etc/rethinkdb/instances.d/default.conf):

# Automatically generated by puppet
runuser=rethinkdb
rungroup=rethinkdb
directory=/var/lib/rethinkdb/instances.d/default
pid-file=/var/run/rethinkdb/instances.d/default.pid
driver-port=28015
cluster-port=29015
http-port=8081

bind=all

The default for the bind parameter is probably not ideal, but it'll make everything work out of the box. You can probably change it to the machine's IP address on the LAN (e.g. 10.0.*.* or 192.168.*.*) for something less open. Your mileage may vary.

See the RethinkDB docs for more detail on configuration options.

What actually happens

Installs rethinkdb via its ppa
Creates a user/group for the rethinkdb service
Generates a conf file and puts it into /etc/rethinkdb/instances.d
Runs rethinkdb create -d /var/lib/rethinkdb/instances.d, which is the default directory
Ensures the init.d service will run on startup

Recommend Projects