cookbook 'memcached', '= 2.0.0'
memcached
(65) Versions
2.0.0
-
-
7.0.26
-
7.0.25
-
7.0.24
-
7.0.23
-
7.0.22
-
7.0.21
-
7.0.20
-
7.0.19
-
7.0.18
-
7.0.17
-
7.0.16
-
7.0.15
-
7.0.14
-
7.0.13
-
7.0.12
-
7.0.11
-
7.0.10
-
7.0.9
-
7.0.8
-
7.0.7
-
7.0.6
-
7.0.5
-
7.0.4
-
7.0.3
-
7.0.2
-
7.0.1
-
7.0.0
-
6.1.0
-
6.0.1
-
6.0.0
-
5.1.1
-
5.1.0
-
5.0.2
-
5.0.0
-
4.1.0
-
4.0.1
-
3.0.3
-
3.0.1
-
3.0.0
-
2.1.0
-
2.0.3
-
2.0.2
-
2.0.1
-
2.0.0
-
1.9.0
-
1.8.0
-
1.7.2
-
1.7.0
-
1.6.6
-
1.6.4
-
1.6.2
-
1.6.0
-
1.5.0
-
1.4.0
-
1.3.0
-
1.2.0
-
1.1.2
-
1.1.0
-
1.0.4
-
1.0.2
-
1.0.0
-
0.10.4
-
0.10.3
-
0.10.2
-
0.8.0
Follow131
- 7.0.26
- 7.0.25
- 7.0.24
- 7.0.23
- 7.0.22
- 7.0.21
- 7.0.20
- 7.0.19
- 7.0.18
- 7.0.17
- 7.0.16
- 7.0.15
- 7.0.14
- 7.0.13
- 7.0.12
- 7.0.11
- 7.0.10
- 7.0.9
- 7.0.8
- 7.0.7
- 7.0.6
- 7.0.5
- 7.0.4
- 7.0.3
- 7.0.2
- 7.0.1
- 7.0.0
- 6.1.0
- 6.0.1
- 6.0.0
- 5.1.1
- 5.1.0
- 5.0.2
- 5.0.0
- 4.1.0
- 4.0.1
- 3.0.3
- 3.0.1
- 3.0.0
- 2.1.0
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 1.9.0
- 1.8.0
- 1.7.2
- 1.7.0
- 1.6.6
- 1.6.4
- 1.6.2
- 1.6.0
- 1.5.0
- 1.4.0
- 1.3.0
- 1.2.0
- 1.1.2
- 1.1.0
- 1.0.4
- 1.0.2
- 1.0.0
- 0.10.4
- 0.10.3
- 0.10.2
- 0.8.0
Installs memcached and includes memcached_instance resource for setting up memcached instances
cookbook 'memcached', '= 2.0.0', :supermarket
knife supermarket install memcached
knife supermarket download memcached
memcached Cookbook
Installs/configures a single memcached instance managed by the systems init system. Also provides a custom resource to set up one or more memcached instances running under runit.
Requirements
Platforms
- Debian / Ubuntu
- RHEL and derivatives
- Fedora
- openSUSE/SLES
- SmartOS base64 1.8.1 - Note that SMF directly configures memcached with no opportunity to alter settings. If you need custom parameters, use the
memcached_instance
provider instead.
Chef
- Chef 12+
Cookbooks
- runit
- yum-epel
- compat_resource
Attributes
The following are node attributes are used to configure /etc/memcached.conf
if using the default.rb recipe. They are not used if using the memcached_instance custom resource.
-
memcached['memory']
- maximum memory for memcached instances. -
memcached['user']
- user to run memcached as. -
memcached['port']
- TCP port for memcached to listen on. -
memcached['udp_port']
- UDP port for memcached to listen on. -
memcached['listen']
- IP address for memcache to listen on, defaults to 0.0.0.0 (world accessible). -
memcached['maxconn']
- maximum number of connections to accept (defaults to 1024) -
memcached['max_object_size']
- maximum size of an object to cache (defaults to 1MB) -
memcached['logfilepath']
- path to directory where log file will be written. -
memcached['logfilename']
- logfile to which memcached output will be redirected in $logfilepath/$logfilename. -
memcached['threads']
- Number of threads to use to process incoming requests. The default is 4. -
memcached['experimental_options']
- Comma separated list of extended or experimental options. (array) -
memcached['ulimit']
- booleantrue
will set the ulimit to themaxconn
value
Usage
This cookbook can be used to to setup a single memcached instance running under the system's init provider by including memcached::default
on your runlist. The above documented attributes can be used to control the configuration of that service.
The cookbook can also within other cookbooks in your infrastructure with the memcached_instance
custom resource. See the documentation below for the usage and examples of that custom resource.
Custom Resources
instance
Adds or removes an instance of memcached running under the runit supervisor.
Actions
- :add: Add a new instance
- :remove: Remove an existing instance
Properties
- :memory - the amount of memory allocated for the cache. default: 64
- :port - the TCP port to listen on. default: 11,211
- :udp_port - the UDP port to listen on. default: 11,211
- :listen - the IP to listen on. default: '0.0.0.0'
- :maxconn - the maximum number of connections to accept. default: 1024
- :user - the user to run as
- :threads - the number of threads to use
- :max_object_size - the largest object size to store
- :experimental_options - an array of additional config options
- :ulimit - the ulimit setting to use for the service
- :template_cookbook - the cookbook containing the runit service template. default: memcached
Examples
Create a new memached instance named super_custom_memcached:
memcached_instance 'super_custom_memcached' do port 11_212 memory 128 end
Stop and disable the super_custom_memcached instance:
memcached_instance 'super_custom_memcached' do action :remove end
License & Authors
- Author:: Cookbook Engineering Team (cookbooks@chef.io)
- Author:: Joshua Sierles (joshua@37signals.com)
Copyright:: 2009-2015, Chef Software, Inc Copyright:: 2009, 37signals Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
memcached Cookbook CHANGELOG
This file is used to list changes made in each version of the memcached cookbook.
2.0.0 (2015-11-10)
BREAKING CHANGES:
- The user and group attributes have been removed and are instead handled by a helper that picks the appropriate user / group based on the platform
- The memcached_instance definition that used both passed values and node attributes for configuration has been rewritten as a 12.5 custom resource with compat_resource providing backwards compatibility to all Chef 12.X releases. This new custom resource handles the installation of memcached and all configuration is passed in via custom resource properties. See the readme for examples of how to use this new resource. This change should greatly improve the ability to use memcached_instance within wrapper cookbooks.
1.9.0 (2015-11-05)
NOTE: This will be the last version of this cookbook that supports Chef 11 and the traditional attribute / resource hybrid setup for memcached instances. After this release this cookbook will function with attributes for a simple install or Chef 12.5 custom resources for creating individual memcached instances. If you utilize memcached instances using the attributes to define the config you'll need to pin to ~1.0 and later update to the new format in ~2.0.
- Debian/Ubuntu switched the user that memcached runs under from nobody to memcache. Updated the cookbook to use this user on those platforms and create it in case we're on an older distro release that didn't yet have that user
- Removed use of shellout that was causing issues for users
- Improved the workaround on Debian/Ubuntu for not starting the service on package install so that it doesn't show up as a changed resource on every Chef run
- Updated Chefspec to 4.X and added additional specs
- Add oracle to the metadata
- Add issues_url and source_url to the metadata
- Add new contributing.md, maintainers.md, and testing.md docs
- Add travis and cookbook version badges to the readme
- Clarified Chef 11 is the minimum required chef release
- Updated platforms in the Kitchen config
- Added chefignore file
- Removed all hash rockets
- Added a .foodcritic file with exclusions
- Updated travis to use their container infrastructure, chef-dk for testing deps, and kitchen-docker for integration testing
- Added a Rakefile to simplify testing
- Removed yum as a dependency as it wasn't being used.
- Removed attributes from the metadata as they hadn't been updated
v1.8.0 (2015-08-11)
- updated serverspec tests to pass (See 3c7b5c9)
- deconflict memcached_instance runit definition from default init (See b06d2d)
- split
default.rb
intoinstall.rb
andconfigure.rb
so that memcached_instance only starts the specified number of instances
- split
- added attributes
logfilepath
,version
,threads
,experimental_options
, andulimit
- NOTE: if memcached_instance name is not specified or set to "memcached", the instance name will be "memcached". If anything else is specified, the instance name will be "memcached-${name}"
v1.7.2 (2014-03-12)
- [COOK-4308] - Enable memcache on RHEL, Fedora, and Suse
- [COOK-4212] - Support max_object_size rhel and fedora
v1.7.0
Updating for yum ~> 3.0.
Fixing up style issues for rubocop.
Updating test-kitchen harness
v1.6.6
fixing metadata version error. locking to 3.0
v1.6.4
Locking yum dependency to '< 3'
v1.6.2
[COOK-3741] UDP settings for memcached
v1.6.0
Bug
- COOK-3682 - Set user when using Debian packages
Improvement
- COOK-3336 - Add an option to specify the logfile (fix)
v1.5.0
Improvement
Bug
-
COOK-2990 - Include
listen
,maxconn
, anduser
in the runit service
New Feature
- COOK-2790 - Add support for defining max object size
v1.4.0
Improvement
- [COOK-2756]: add SUSE support to memcached cookbook
- [COOK-2791]: Remove the template for Karmic from the memcached cookbook
Bug
- [COOK-2600]: support memcached on SmartOS
v1.3.0
- [COOK-2386] - update
memcached_instance
definition forrunit_service
resource
v1.2.0
- [COOK-1469] - include yum epel recipe on RHEL 5 (introduces yum cookbook dependency)
- [COOK-2202] - Fix typo in previous ticket/commits
- [COOK-2266] - pin runit dependency
v1.1.2
- [COOK-990] - params insite runit_service isn't the same as outside
v1.1.0
- [COOK-1764] - Add Max Connections to memcached.conf and fix typos
v1.0.4
- [COOK-1192] - metadata doesn't include RH platforms (supported)
- [COOK-1354] - dev package changed name on centos6
v1.0.2
- [COOK-1081] - support for centos/rhel
v1.0.0
- [COOK-706] - Additional info in README
- [COOK-828] - Package for RHEL systems
v0.10.4
- Current released version
Foodcritic Metric
2.0.0 failed this metric
FC016: LWRP does not declare a default action: /tmp/cook/2789eb122df9acd8c0f28d6a/memcached/resources/instance.rb:1
2.0.0 failed this metric