New Supermarket Announcements!

Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the supermarket mailing list.

Select Supported Platforms

RSS

memcached (20) Versions 1.8.0

Installs memcached and provides a define to set up an instance of memcache via runit

Berkshelf
Librarian
Knife
cookbook 'memcached', '~> 1.8.0'
cookbook 'memcached', '~> 1.8.0'
knife cookbook site install memcached
knife cookbook site download memcached
README
Dependencies
Changelog
Foodcritic

memcached Cookbook

Build Status

Installs memcached and provides a define to set up an instance of memcache via runit.

Requirements

A runit service can be set up for instances using the memcache_instance definition.

Platforms

  • Ubuntu 10.04, 12.04
  • CentOS/RHEL 5.8, 6.3
  • openSUSE 12.3
  • SLES 12 SP2
  • 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.

May work on other systems with or without modification.

Cookbooks

  • runit
  • yum
  • yum-epel

Attributes

The following are node attributes passed to the template for the runit service.

  • 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'] - boolean true will set the ulimit to the maxconn value

Usage

Simply set the attributes and it will configure the /etc/memcached.conf file. If you want to use multiple memcached instances, you'll need to modify the recipe to disable the startup script and the template in the default recipe.

Use the definition, memcached_instance, to set up a runit service for the named memcached instance. (If the instance name is memcached the service name will be memcached otherwise it will be memcached-#{service_name})

memcached_instance 'myproj'

The recipe also reads in whether to start up memcached from a /etc/default/memcached "ENABLE_MEMCACHED" setting, which is "yes" by default.

License & Authors

Copyright:: 2009-2012, 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.

Dependent cookbooks

yum-epel >= 0.0.0
yum ~> 3.0
runit ~> 1.0

Contingent cookbooks

chef-manageiq Applicable Versions
ftp-cloudfs Applicable Versions
gitorious Applicable Versions
graphite Applicable Versions
mcrouter Applicable Versions
nodestack Applicable Versions
noosfero Applicable Versions
phpstack Applicable Versions
pythonstack Applicable Versions
stack_commons Applicable Versions

memcached Cookbook CHANGELOG

This file is used to list changes made in each version of the memcached cookbook.

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 into install.rb and configure.rb so that memcached_instance only starts the specified number of instances
  • added attributes logfilepath, version, threads, experimental_options, and ulimit
  • 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

  • COOK-3336 - Add option to specify logfile
  • COOK-3299 - Document that memcached is exposed by default

Bug

  • COOK-2990 - Include listen, maxconn, and user 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 for runit_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
FC015: Consider converting definition to a LWRP: /tmp/cook/7bb7d582cda0517e178c796c/memcached/definitions/memcached_instance.rb:1
FC031: Cookbook without metadata file: /tmp/cook/7bb7d582cda0517e178c796c/memcached/metadata.rb:1
FC045: Consider setting cookbook name in metadata: /tmp/cook/7bb7d582cda0517e178c796c/memcached/metadata.rb:1