puppet-memcached

Manage memcached via Puppet

Show some love

If you find this module useful, send some bitcoins to 1Na3YFUmdxKxJLiuRXQYJU2kiNqA3KY2j9

Supported Puppet versions

• Puppet >= 4
• Last version supporting Puppet 3: v3.0.2

How to use

Starting with version 3.0.0, memcached will be listening on 127.0.0.1 only.
This should make setups more secure (e.g. if there are no firewall rules in place).

To change this behavior, you need to set listen_ip to '0.0.0.0'.

Use roughly 90% of memory

    class { 'memcached': }

Set a fixed memory limit in MB

    class { 'memcached':
      max_memory => 2048
    }

Use 12% of available memory

    class { 'memcached':
      max_memory => '12%'
    }

Other class parameters

• $package_ensure = 'present'
• $logfile = '/var/log/memcached.log'
• $logstdout = false (Set this to true to disable logging to a file/syslog entirely, useful when memcached runs in containers)
• $pidfile = '/var/run/memcached.pid' (Debian family only, set to false to disable pidfile)
• $max_memory = false
• $max_item_size = false
• $min_item_size = false
• $factor = false
• $lock_memory = false (WARNING: good if used intelligently, google for -k key)
• $listen_ip = '127.0.0.1'
• $tcp_port = 11211
• $udp_port = 11211
• $manage_firewall = false
• $user = '' (OS specific setting, see params.pp)
• $max_connections = 8192
• $verbosity = undef
• $unix_socket = undef
• $install_dev = false (TRUE if 'libmemcached-dev' package should be installed)
• $processorcount = $::processorcount
• $service_restart = true (restart service after configuration changes, false to prevent restarts)
• $use_sasl = false (start memcached with SASL support)
• $use_tls = false (start memcached with TLS support)
• $tls_cert_chain = undef
• $tls_key = undef
• $tls_ca_cert = undef
• $tls_verify_mode = 1 (0: None, 1: Request, 2: Require, 3: Once)
• $large_mem_pages = false (try to use large memory pages)

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[3.7.0]

Added

• Add support to set TLS parameters in /etc/sysconfig/memcached (#113)

Fixed

• Make ssl_ca_cert optional (#112)

[3.6.0]

Added

• Add TLS support (#109)

[3.5.0]

Fixed

• allow FreeBSD to set max memory (#104)

Changed

• Dependencies updated (#107)
• Better FreeBSD tests

[3.4.0]

Fixed

• factor should be a string or number, not boolean

Added

• Add Puppet 6 to travis checks

Changed

• Update Puppet version requirement to include version 6 (< 7.0.0)
• Unpin firewall module in fixtures
• Require puppetlabs_spec_helper >= 2.11.0

Removed

• Drop Ruby 2.1 from travis checks