cookbook 'couchbase-ng', '= 1.3.1'
couchbase-ng (2) Versions 1.3.1 Follow0
Installs and configures Couchbase Server.
cookbook 'couchbase-ng', '= 1.3.1', :supermarket
knife supermarket install couchbase-ng
knife supermarket download couchbase-ng
Description
Installs and configures Couchbase.
This cookbook is a fork of the Supermarket "couchbase" cookbook with additional features that are waiting to be pulled in.
Features / Fixes
- [woodsae] - Add options
replica_index
andflush_enabled
- [DennyZhang] - Fix issue 26: couchbase_node wait until couchbase is up and running
Requirements
Chef 0.10.10 and Ohai 0.6.12 are required due to the use of platform_family.
Platforms
- Debian family (Debian, Ubuntu etc)
- Red Hat family (Redhat, CentOS, Oracle etc)
- Microsoft Windows
Note that Couchbase Server does not support Windows 8 or Server 2012: see http://www.couchbase.com/issues/browse/MB-6395. This is targeted to be fixed in Couchbase 2.1.
Attributes
couchbase-server
-
node['couchbase']['server']['edition']
- The edition of couchbase-server to install, "community" or "enterprise" -
node['couchbase']['server']['version']
- The version of couchbase-server to install -
node['couchbase']['server']['package_file']
- The couchbase-server package file to download and install -
node['couchbase']['server']['package_base_url']
- The url path to download the couchbase-server package file from -
node['couchbase']['server']['package_full_url']
- The full url to the couchbase-server package file to download and install -
node['couchbase']['server']['database_path']
- The directory Couchbase should persist data to -
node['couchbase']['server']['index_path']
- The directory Couchbase should write indexes to -
node['couchbase']['server']['log_dir']
- The directory Couchbase should log to -
node['couchbase']['server']['memory_quota_mb']
- The per server RAM quota for the entire cluster in megabytes defaults to Couchbase's maximum allowed value -
node['couchbase']['server']['username']
- The cluster's username for the REST API and Admin UI -
node['couchbase']['server']['password']
- The cluster's password for the REST API and Admin UI - `node['couchbase']['server']['allow_unsigned_packages'] - Whether to allow Couchbase's unsigned packages to be installed (default to 'true')
client
-
node['couchbase']['client']['version']
- The version of libcouchbase to install
moxi
-
node['couchbase']['moxi']['version']
- The version of moxi to install -
node['couchbase']['moxi']['package_file']
- The package file to download -
node['couchbase']['moxi']['package_base_url']
- The base URL where the packages are located -
node['couchbase']['moxi']['package_full_url']
- The full URL to the moxi package -
node['couchbase']['moxi']['cluster_server']
- The bootstrap server for moxi to contact for the node list -
node['couchbase']['moxi']['cluster_rest_url']
- The bootstrap server's full REST URL for retrieving the initial node list
buckets
-
mybucket1
- The name to use for the Couchbase bucket -
node['couchbase']['buckets']['mybucket1']['cluster']
- The name of the cluster the bucket belongs to, defaults to "default" -
node['couchbase']['buckets']['mybucket1']['type']
- The type of the bucket, defaults to "couchbase" -
node['couchbase']['buckets']['mybucket1']['saslpassword']
- The password of the bucket, defaults to "" -
node['couchbase']['buckets']['mybucket1']['replicas']
- Number of replica (backup) copies, defaults to 1. Set to false to disable -
node['couchbase']['buckets']['mybucket1']['username']
- The username to use to authenticate with Couchbase -
node['couchbase']['buckets']['mybucket1']['password']
- The password to use to authenticate with Couchbase -
node['couchbase']['buckets']['mybucket1']['memory_quota_mb']
- The bucket's per server RAM quota for the entire cluster in megabytes -
node['couchbase']['buckets']['mybucket1']['memory_quota_percent']
- The bucket's RAM quota as a percent (0.0-1.0) of the cluster's quota
Recipes
client
Installs the libcouchbase2 and devel packages.
server
Installs the couchbase-server package and starts the couchbase-server service.
moxi
Installs the moxi-server package and starts the moxi-server service.
buckets
Creates or updates buckets.
Resources/Providers
couchbase_node
Actions
-
:modify
- Default Modify the configuration of the node
Attribute Parameters
-
id
- The id of the Couchbase node, typically "self", defaults to the resource name -
database_path
- The directory the Couchbase node should persist data to -
username
- The username to use to authenticate with Couchbase -
password
- The password to use to authenticate with Couchbase
Examples
couchbase_node "self" do database_path "/mnt/couchbase-server/data" username "Administrator" password "password" end
couchbase_cluster
Actions
-
:create_if_missing
- Default Create a cluster/pool only if it doesn't exist yet
Attribute Parameters
-
cluster
- The id of the Couchbase cluster, typically "default", defaults to the resource name -
memory_quota_mb
- The per server RAM quota for the entire cluster in megabytes -
username
- The username to use to authenticate with Couchbase -
password
- The password to use to authenticate with Couchbase
Examples
couchbase_cluster "default" do memory_quota_mb 256 username "Administrator" password "password" end
couchbase_settings
Actions
-
:modify
- Default Modify the collection of settings
Attribute Parameters
-
group
- Which group of settings to modify, defaults to the resource name -
settings
- The hash of settings to modify -
username
- The username to use to authenticate with Couchbase -
password
- The password to use to authenticate with Couchbase
Examples
couchbase_settings "autoFailover" do settings({ "enabled" => true, "timeout" => 30, }) username "Administrator" password "password" end
couchbase_bucket
Actions
-
:create
- Default Create a Couchbase bucket
Attribute Parameters
-
bucket
- The name to use for the Couchbase bucket, defaults to the resource name -
cluster
- The name of the cluster the bucket belongs to, defaults to "default" -
type
- The type of the bucket, defaults to "couchbase" -
saslpassword
- The password of the bucket, defaults to "" -
memory_quota_mb
- The bucket's per server RAM quota for the entire cluster in megabytes -
memory_quota_percent
- The bucket's RAM quota as a percent (0.0-1.0) of the cluster's quota -
replicas
- Number of replica (backup) copies, defaults to 1. Set to false to disable -
username
- The username to use to authenticate with Couchbase -
password
- The password to use to authenticate with Couchbase
Examples
couchbase_bucket "default" do memory_quota_mb 128 replicas 2 username "Administrator" password "password" end couchbase_bucket "pillowfight" do memory_quota_percent 0.5 replicas false saslPassword "bucketPassword" username "Administrator" password "password" end couchbase_bucket "memcached" do memory_quota_mb 128 replicas false type "memcached" username "Administrator" password "password" end
Chef Solo Note
These node attributes are stored on the Chef
server when using chef-client
. Because chef-solo
does not
connect to a server or save the node object at all, to have the same
passwords persist across chef-solo
runs, you must specify them in
the json_attribs
file used. For example:
{
"couchbase": {
"server": {
"password": "somepassword"
}
}
"run_list":["recipe[couchbase::server]"]
}
Couchbase Server expects the password to be longer than six characters.
An example to configure buckets with chef-solo
:
{
"couchbase": {
"server": {
"password": "somepassword"
},
"buckets": {
"mybucket1": true,
"mymemcached1": {
"type": "memcached",
"memory_quota_mb": 500
}
}
}
"run_list":["recipe[couchbase::server]"]
}
Roadmap
- Many of the heavyweight resources/providers need to be moved to LWRPs.
If you have time to work on these things or to improve the cookbook in other ways, please submit a pull request.
License and Author
- Author:: Chris Griego (cgriego@getaroom.com)
- Author:: Morgan Nelson (mnelson@getaroom.com)
- Author:: Julian Dunn (jdunn@aquezada.com)
Author:: Enrico Stahn (mail@enricostahn.com)
Copyright:: 2012, getaroom
Copyright:: 2012, SecondMarket Labs, LLC.
Copyright:: 2013, Opscode, Inc.
Copyright:: 2013, Zanui
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Dependent cookbooks
apt >= 0.0.0 |
openssl >= 0.0.0 |
windows >= 0.0.0 |
yum >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
v1.3.0 (2014-10-25)
- Update to Couchbase 3.0.0.
- Update to Moxi Server 2.5.0.
- Update unit tests to rspec3
- [GH-28] Added index_path
v1.2.0 (2014-04-10)
- Update to Couchbase 2.2.0.
- [GH-13] Add 'buckets' recipe to manipulate buckets.
- [GH-19] Repair Ubuntu package name changes.
v1.1.0
- Update to Couchbase 2.0.1.
- Add Test Kitchen 1.0.0 support and integration with Travis CI.
- [GH-2] Add a helper to check that Couchbase is actually up before trying to create buckets, etc.
- [GH-4] Allow SASL passwords to be used as bucket passwords
- [GH-7] Only set password if not set at other precedence levels. Also remove unnecessary node.save
- [GH-8] Added extra dep on libssl0.9.8 on Debian/Ubuntu
- [GH-9] Don't hardcode install_dir, use the node attribute instead
- [GH-10] Fix broken spec tests from GH-4
- [GH-11] Couchbase doesn't sign their packages, so on some RHEL distributions make sure we do --nogpgcheck
v1.0.0
- Initial release
Foodcritic Metric
1.3.1 failed this metric
FC031: Cookbook without metadata file: /tmp/cook/69ed4ce2dcb735654e555204/couchbase-ng/metadata.rb:1
FC045: Consider setting cookbook name in metadata: /tmp/cook/69ed4ce2dcb735654e555204/couchbase-ng/metadata.rb:1
1.3.1 failed this metric
FC045: Consider setting cookbook name in metadata: /tmp/cook/69ed4ce2dcb735654e555204/couchbase-ng/metadata.rb:1