Ansible Role: Redis

❗ Report issues and send Pull Requests in the main Ansible Role repository ❗

This role will deal with the setup of Redis.

It's part of the Manala Ansible stack but can be used as a stand alone component.

Requirements

None.

Dependencies

None.

Installation

Ansible 2+

Using ansible galaxy cli:

ansible-galaxy install manala.redis

Using ansible galaxy requirements file:

- src: manala.redis

Role Handlers

Name	Type	Description
redis restart	Service	Restart redis server
redis-sentinel restart	Service	Restart redis sentinel

Role Variables

Name	Default	Type	Description
manala_redis_version	~	String	Version (autodetect if null)
manala_redis_install_packages	~	Array	Dependency packages to install
manala_redis_install_packages_default	['redis-server']/['redis-sentinel']	Array	Default dependency packages to install
manala_redis_server	true	Boolean	Install and configure "redis-server"
manala_redis_server_config_file	'/etc/redis/redis.conf'	String	Configuration file path
manala_redis_server_config_template	~	String	Configuration template path
manala_redis_server_config	~	Array/String	Configuration directives
manala_redis_sentinel	false	Boolean	Install and configure "redis-sentinel"
manala_redis_sentinel_config_file	'/etc/redis/sentinel.conf'	String	Sentinel configuration file path
manala_redis_sentinel_config	{}	Array	Sentinel configuration directives

Configuration example

Redis server

Use debian default main config template (recommended):

manala_redis_server_config_template: config/debian/redis.conf.j2
manala_redis_server_config:
  include:
    - /foo/bar.conf
    - /foo/baz.conf
  port: 1234

Use dict parameters:

manala_redis_server_config:
  include:
    - /foo/bar.conf
    - /foo/baz.conf
  port: 1234

Use raw main config:

manala_redis_server_config: |
  include /foo/bar.conf
  include /foo/baz.conf
  port 1234

Use dict's array parameters (deprecated):

manala_redis_server_config:
  - port: 1234

Redis sentinel

manala_redis_sentinel: true
manala_redis_sentinel_config:
    sentinel monitor: mymaster 192.168.0.10 6379 2
    sentinel auth-pass: mymaster f00bar
    sentinel down-after-milliseconds: mymaster 5000
    protected-mode: "no"

Example playbook

- hosts: servers
  roles:
    - role: manala.redis

Licence

MIT

Author information

Manala (http://www.manala.io/)