Version information
released Sep 20th 2014
Start using this module
Add this module to your Puppetfile:
mod 'tmont-rethinkdb', '0.1.0'
Learn more about managing modules with a PuppetfileDocumentation
tmont/rethinkdb — version 0.1.0 Sep 20th 2014
puppet-rethinkdb
A Puppet module for RethinkDB.
Dependencies
Limitations
- Only works under Ubuntu. Sorry.
- Only supports a single instance per machine
- It requires a user/group for the service (defaults to
rethinkdb
andrethinkdb
)
Installation
- Via puppet forge: http://forge.puppetlabs.com/tmont/rethinkdb
- Via git submodule:
git submodule add git@github.com: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 repo
- 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
Dependencies
- puppetlabs/stdlib (>= 4.3.2)
- puppetlabs/apt (>= 1.6.0)