geerlingguy / ansible-role-memcached Goto Github PK

View Code? Open in Web Editor NEW

68.0 8.0 69.0 47 KB

Ansible Role - Memcached

Home Page: https://galaxy.ansible.com/geerlingguy/memcached/

License: MIT License

Jinja 100.00%

ansible role memcached cache caching performance database layer

ansible-role-memcached's Introduction

Ansible Role: Memcached

An Ansible Role that installs Memcached on RedHat/CentOS or Debian/Ubuntu Linux.

Requirements

None.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

memcached_user: memcache

The user under which the Memcached daemon will run.

memcached_port: 11211
memcached_listen_ip: 127.0.0.1

The port and IP address (127.0.0.1 for localhost) on which Memcached will listen for requests.

memcached_threads: 4

Number of threads to run.

memcached_memory_limit: 64
memcached_max_item_size: 1m
memcached_connections: 1024

Memcached limits. The maximum amount of RAM memcached will consume (64MB is the default), the memory-limit of a single item and the maximum number of simultaneous connections memcached will handle.

memcached_log_file: /var/log/memcached.log

The location of the memcached log file.

memcached_log_verbosity: ""

Normally memcached does not log anything. Change to "-v" to enable logging or to "-vv" for debug logging.

Dependencies

None.

Example Playbook

- hosts: cache
  roles:
    - { role: geerlingguy.memcached }

License

MIT / BSD

Author Information

This role was created in 2014 by Jeff Geerling, author of Ansible for DevOps.

ansible-role-memcached's People

Contributors

Stargazers

Watchers

ansible-role-memcached's Issues

Option for installing libmemcached-tools

Would a hosts option for installing libmemcached-tools be useful?

Log file is not created/written to (EL7)

By default, the log file is set to /var/log/memcached.log but the file is never created or written to. Even when setting the debug level to -vvv the file remains uncreated. I had wondered if this was a permissions issue since the process runs as the memcached user and the /var/log directory is only writable by root, but even after creating the file manually and setting write permission to the memcached user, the file remained empty. It seems that the debug information is instead readable in journalctl.

Memcached service not restarted after install

Steps to reproduce:

Generate a VM (Ubuntu)
Run this role
Memcached runs with old configuration instead of the ansible-provisioned one

The handler r_estart memcached_ doesn't fire after a clean install. That means that - for example - memcached still listens on localhost instead of a specific configured IP-address.

I think this line should be removed from the handler, because it is default behaviour of Ansible to not call a handler if the status is not changed afaik.

when: not memcached_install.changed

Configuration is not reloaded on first install

When I set up a new server I set the listening address and it doesn't pick up the change.

I need to manually restart the service for changes to be picked up.

I think this is due to this condition: https://github.com/geerlingguy/ansible-role-memcached/blob/master/handlers/main.yml#L4

On debian 8 memcached runs with default config regardless it was generated correctly

Memcached is started by systemd right after pakage installation, so handler doesn't work even if config was changed

Add support for changing chunk size

Chunk size is set in OPTIONS with "I":

-I 16M

So the proposed change would be:

Variable (default size is 1MB = 1M):

memcached_chunk_size: 1M

And in the template (note, it's I not L):

OPTIONS="-I {{ memcached_chunk_size }} -l {{ memcached_listen_ip }} {{ memcached_log_verbosity }} >> {{ memcached_log_file }} 2>&1"

e.g. service memcached stop" doesn't stop the process correctly as output via ps shows the process is still running
"ps aux | grep memcache"

Add support for running with socket

-s flag is used for running with a socket.

need to create a directory for the socket