Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/saz/puppet-memcached
Puppet module for memcached
https://github.com/saz/puppet-memcached
memcached puppet
Last synced: 3 days ago
JSON representation
Puppet module for memcached
- Host: GitHub
- URL: https://github.com/saz/puppet-memcached
- Owner: saz
- License: other
- Created: 2011-09-13T14:06:18.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2024-11-13T07:29:35.000Z (3 months ago)
- Last Synced: 2025-01-31T01:32:28.116Z (4 days ago)
- Topics: memcached, puppet
- Language: Ruby
- Homepage:
- Size: 300 KB
- Stars: 58
- Watchers: 7
- Forks: 155
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# memcached module for Puppet
[](https://github.com/saz/puppet-memcached/actions?query=workflow%3ACI)
Manage memcached via Puppet
## 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).
For the old behaviour, you need to set listen to '0.0.0.0'.
```
### Use roughly 90% of memory
```ruby
class { 'memcached': }
```
### Set a fixed memory limit in MB
```ruby
class { 'memcached':
max_memory => 2048
}
```
### Use 12% of available memory
```ruby
class { 'memcached':
max_memory => '12%'
}
```
### Install multiple memcached instances
the multiinstance support uses a systemd instance unit file. This will be placed
at `/etc/systemd/system/[email protected]`. It allows us to manage multiple
instances via the same unit file. To start a simple instance, you only need to
know the desired TCP port:
```puppet
memcached::instance{'11222':}
```
that's it! It will bind to localhost and listen to TCP port 11222. You might
want to tune the systemd limits, for example the number of file descriptors
(LimitNOFILE) or the number of processes (LimitNPROC):
```puppet
memcached::instance{'11222':
limits => {
'LimitNOFILE' => 8192,
'LimitNPROC' => 16384,
}
}
```
All systemd limits are documented in the [systemd documentation](https://www.freedesktop.org/software/systemd/man/systemd.exec.html#Process%20Properties).
Another usecase. Let's assume your name is Eric and you want to change the
actual memcached parameters, for example to bind it to every interface:
```puppet
memcached::instance{'11222':
override_content => "[Service]\nEnvironment='LISTEN=-l 0.0.0.0'",
}
```
Maybe Eric also wants to override the cache size (the unit is MB):
```puppet
memcached::instance{'11222':
override_content => "[Service]\nEnvironment=CACHESIZE=4096\n",
}
```
last but not least, Eric might also want to override the maximum amount
of connections (the default is 1024):
```puppet
memcached::instance{'11222':
override_content => "[Service]\nEnvironment=MAXCONN=4096\n",
}
```
Now Eric wants to use all those three settings at the same time:
```puppet
memcached::instance{'11222':
override_content => "[Service]\nEnvironment=MAXCONN=4096\nEnvironment=CACHESIZE=4096\nEnvironment='LISTEN=-l 0.0.0.0'\n",
}
```
Instead of passing a long string with multiple `\n`, Eric can also put the
content in a file and provide that:
```puppet
memcached::instance{'11222':
override_source => "${module_name}/memcached_11222_override.conf\n",
}
```