Ansible Redis Role

redis is an ansible role which:

• installs redis
• configures redis
• configures service

Installation

Using ansible-galaxy:

$ ansible-galaxy install franklinkim.redis

Using requirements.yml:

- src: franklinkim.redis

Using git:

$ git clone https://github.com/weareinteractive/ansible-redis.git franklinkim.redis

Variables

Here is a list of all the default variables for this role, which are also available in defaults/main.yml.

# Accept connections on the specified port, default is 6379.
# If port 0 is specified Redis will not listen on a TCP socket.
redis_port: 6379
# By default Redis does not run as a daemon. Use 'yes' if you need it.
# Note that Redis will write a pid file in /var/run/redis.pid when daemonized.
redis_daemonize: 'yes'
# By default Redis listens for connections from all the network interfaces
# available on the server. It is possible to listen to just one or multiple
# interfaces using the "bind" configuration directive, followed by one or
# more IP addresses.
redis_bind: []
# Specify the server verbosity level.
# This can be one of:
# debug (a lot of information, useful for development/testing)
# verbose (many rarely useful info, but not a mess like the debug level)
# notice (moderately verbose, what you want in production probably)
# warning (only very important / critical messages are logged)
redis_loglevel: notice
# Set the number of databases. The default database is DB 0, you can select
# a different one on a per-connection basis using SELECT <dbid> where
# dbid is a number between 0 and 'databases'-1
redis_databases: 16
# Save the DB on disk <seconds> <changes>
redis_save:
  - 900 1
  - 300 10
  - 60 10000
# apt repository
redis_repository: ppa:chris-lea/redis-server
# package name (version)
redis_package: redis-server
# start on boot
redis_service_enabled: yes
# current state: started, stopped
redis_service_state: started

Handlers

These are the handlers that are defined in handlers/main.yml.

• restart redis-server

Example playbook

- hosts: all
  sudo: yes
  roles:
    - franklinkim.redis
  vars:
    redis_bind:
      - 127.0.0.1
    redis_databases: 2

Testing

$ git clone https://github.com/weareinteractive/ansible-redis.git
$ cd ansible-redis
$ vagrant up

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests and examples for any new or changed functionality.

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

License

Copyright (c) We Are Interactive under the MIT license.