Installs and configures Couchbase.
Chef 0.10.10 and Ohai 0.6.12 are required due to the use of platform_family.
- 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.
node['couchbase']['server']['edition']- The edition of couchbase-server to install, "community" or "enterprise"node['couchbase']['server']['version']- The version of couchbase-server to installnode['couchbase']['server']['package_file']- The couchbase-server package file to download and installnode['couchbase']['server']['package_base_url']- The url path to download the couchbase-server package file fromnode['couchbase']['server']['package_full_url']- The full url to the couchbase-server package file to download and installnode['couchbase']['server']['database_path']- The directory Couchbase should persist data tonode['couchbase']['server']['index_path']- The directory Couchbase should write indexes tonode['couchbase']['server']['log_dir']- The directory Couchbase should log to defaults to Couchbase's maximum allowed valuenode['couchbase']['server']['username']- The cluster's username for the REST API and Admin UInode['couchbase']['server']['password']- The cluster's password for the REST API and Admin UInode['couchbase']['server']['allow_unsigned_packages']- Whether to allow Couchbase's unsigned packages to be installed (default to 'true')node['couchbase']['server']['community_edition_guid']- The GUID of community edition of couchbase-server. Default value setnode['couchbase']['server']['enterprise_edition_guid']- The GUID of enterprise edition of couchbase-server. Default value set['couchbase']['server']['service_name']- name of couchbase-server service. Default "couchbase-server"
node['couchbase']['cluster']['name']- The name of the cluster this server belongs tonode['couchbase']['cluster']['memory_quota_mb']- The per server RAM quota for the entire cluster in megabytes
node['couchbase']['client']['version']- The version of libcouchbase to install
node['couchbase']['moxi']['version']- The version of moxi to installnode['couchbase']['moxi']['package_file']- The package file to downloadnode['couchbase']['moxi']['package_base_url']- The base URL where the packages are locatednode['couchbase']['moxi']['package_full_url']- The full URL to the moxi packagenode['couchbase']['moxi']['cluster_server']- The bootstrap server for moxi to contact for the node listnode['couchbase']['moxi']['cluster_rest_url']- The bootstrap server's full REST URL for retrieving the initial node list
mybucket1- The name to use for the Couchbase bucketnode['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 disablenode['couchbase']['buckets']['mybucket1']['username']- The username to use to authenticate with Couchbasenode['couchbase']['buckets']['mybucket1']['password']- The password to use to authenticate with Couchbasenode['couchbase']['buckets']['mybucket1']['memory_quota_mb']- The bucket's per server RAM quota for the entire cluster in megabytesnode['couchbase']['buckets']['mybucket1']['memory_quota_percent']- The bucket's RAM quota as a percent (0.0-1.0) of the cluster's quota
Installs the libcouchbase2 and devel packages.
Installs the couchbase-server package and starts the couchbase-server service.
Installs the moxi-server package and starts the moxi-server service.
Creates or updates buckets.
:modify- Default Modify the configuration of the node
id- The id of the Couchbase node, typically "self", defaults to the resource namedatabase_path- The directory the Couchbase node should persist data tousername- The username to use to authenticate with Couchbasepassword- The password to use to authenticate with Couchbase
couchbase_node "self" do
database_path "/mnt/couchbase-server/data"
username "Administrator"
password "password"
end:create_if_missing- Default Create a cluster/pool only if it doesn't exist yet
cluster- The id of the Couchbase cluster, typically "default", defaults to the resource namememory_quota_mb- The per server RAM quota for the entire cluster in megabytesusername- The username to use to authenticate with Couchbasepassword- The password to use to authenticate with Couchbase
couchbase_cluster "default" do
memory_quota_mb 256
username "Administrator"
password "password"
end:modify- Default Modify the collection of settings
group- Which group of settings to modify, defaults to the resource namesettings- The hash of settings to modifyusername- The username to use to authenticate with Couchbasepassword- The password to use to authenticate with Couchbase
couchbase_settings "autoFailover" do
settings({
"enabled" => true,
"timeout" => 30,
})
username "Administrator"
password "password"
end:create- Default Create a Couchbase bucket
bucket- The name to use for the Couchbase bucket, defaults to the resource namecluster- 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 megabytesmemory_quota_percent- The bucket's RAM quota as a percent (0.0-1.0) of the cluster's quotareplicas- Number of replica (backup) copies, defaults to 1. Set to false to disableusername- The username to use to authenticate with Couchbasepassword- The password to use to authenticate with Couchbase
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"
endThese 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]"]
}
- 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.
-
Author:: Chris Griego ([email protected])
-
Author:: Morgan Nelson ([email protected])
-
Author:: Julian Dunn ([email protected])
-
Author:: Enrico Stahn ([email protected])
-
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.