puppet-couchbase: Scalable couchbase module

This module can install couchbase on servers, create buckets and automatically maintain the cluster.

Usage

Install a couchbase server with a standard user/password and create the password-less default bucket:

class { 'couchbase':
    size     => 1024,
    user     => 'couchbase',
    password => 'password',
    version  => latest,
}

Create additional buckets (Note the user/password):

couchbase::bucket { 'memcached':
    port     => 11211,
    size     => 1024,
    user     => 'couchbase',
    password => 'password',
    type     => 'memcached',
    replica  => 1
}

Install the SDK for your language (currently supported ruby and python):

couchbase::client { 'ruby': }

Using it with an unsupported language will install the libcouchbase-devel and libcouchbase2-libevent which are required for any other SDK. So for example if you want to install your php client you should use this to install the required libs and then install the php pecl couchbase extension using another module. Don't forget to define your relationships which in the case of module example42/php could look like::

Class['Couchbase'] -> Couchbase::Client <| |> -> Class['Php'] -> Php::Pecl::Module <| |>

You can add a moxi listener on Windows machines now. It is a resource define so can be added like so:

couchbase::moxi { 'default':
  nodes => ['127.0.0.1:8091'],
}

For more details about Moxi: http://docs.couchbase.com/moxi-manual-1.8/

Notes

This module uses a puppetdb installation (it is actually required) to generate a set of server installation files. These will run on any new node added to the cluster. What this means is that transparently you can add nodes to a Couchbase server group. This could be done via auto-scaling or other methods, as long as they all are assigned to the same server group.

Due to this, the module requires the mentioned puppetdb services as well as storeconfigs, puppetlabs/concat and puppetlabs/stdlib.

Testing

You might want to get some ruby and then:

gem install bundler
bundler install
bundle exec rake test

If you want to do acceptance testing:

bundle exec rake spec_prep
BEAKER_set=ubuntu-1204-x64 BEAKER_destroy=no rake beaker

TODO

• Add the ability to do cleanup of nodes from cluster
• Build more tests into module to increase coverage

2017-07-11 - Version 1.1.0

Bugfixes:

• Couchbase 4.6.2 support patchesfrom rdev5 (Matt Borja)

2016-01-06 - Version 1.0.4

Bugfixes:

• Fixes URL link for ubuntu repository

2015-04-14 - Version 1.0.3

Bugfixes:

• Initialize the autofailover settings via 'setting-autofailover' instead of in cluster

New:

• Add 'index_dir' setting. Thanks to TheMeier.
• New 'download_url_base' setting for location to resolve binary download from. Thanks to ajcrowe

2015-03-20 - Version 1.0.2

Bugfixes:

• Changed default install to community edition.

2014-12-16 - Version 1.0.1

Summary: Fixes bugs with version downloading from couchbase package URL

Bugfixes:

• Couchbase changed URL's again for packages. This fixes it

2014-11-25 - Version 1.0.0

Summary: Syntax changes, package fixes and new resource definition additions.

Bugfixes:

• Moved to metadata format for module.
• Now installs community release by default
• RPM/package update to fix new s3 locations for packages
• Ensure bucket exists based on params
• Remove/add init scripts based upon present/absent state
• Changed init script to refreshonly.
• data directory is now a param

New:

• Moxi resource which can configure the moxi proxy on linux or windows machines. More info about moxi here: http://docs.couchbase.com/moxi-manual-1.8/

Contributions/Thanks: Dmitry Kireev https://github.com/kireevco (Thanks!)