community.general.redis (3.8.10) — module

Install collection

Install with ansible-galaxy collection install community.general:==3.8.10

Add to requirements.yml

  collections:
    - name: community.general
      version: 3.8.10

Description

Unified utility to interact with redis instances.

Requirements

• redis

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Set local redis instance to be a replica of melee.island on port 6377
  community.general.redis:
    command: replica
    master_host: melee.island
    master_port: 6377

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Deactivate replica mode
  community.general.redis:
    command: replica
    replica_mode: master

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Flush all the redis db
  community.general.redis:
    command: flush
    flush_mode: all

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Flush only one db in a redis instance
  community.general.redis:
    command: flush
    db: 1
    flush_mode: db

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Configure local redis to have 10000 max clients
  community.general.redis:
    command: config
    name: maxclients
    value: 10000

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Configure local redis maxmemory to 4GB
  community.general.redis:
    command: config
    name: maxmemory
    value: 4GB

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Configure local redis to have lua time limit of 100 ms
  community.general.redis:
    command: config
    name: lua-time-limit
    value: 100

Inputs

    
db:
    description:
    - The database to flush (used in db mode) [flush command]
    type: int

name:
    description:
    - A redis config key.
    type: str

value:
    description:
    - A redis config value. When memory size is needed, it is possible to specify it in
      the usal form of 1KB, 2M, 400MB where the base is 1024. Units are case insensitive
      i.e. 1m = 1mb = 1M = 1MB.
    type: str

command:
    choices:
    - config
    - flush
    - replica
    - slave
    description:
    - The selected redis command
    - C(config) ensures a configuration setting on an instance.
    - C(flush) flushes all the instance or a specified db.
    - C(replica) sets a redis instance in replica or master mode. (C(slave) is an alias
      for C(replica).)
    type: str

flush_mode:
    choices:
    - all
    - db
    default: all
    description:
    - Type of flush (all the dbs in a redis instance or a specific one) [flush command]
    type: str

login_host:
    default: localhost
    description:
    - The host running the database
    type: str

login_port:
    default: 6379
    description:
    - The port to connect to
    type: int

master_host:
    description:
    - The host of the master instance [replica command]
    type: str

master_port:
    description:
    - The port of the master instance [replica command]
    type: int

replica_mode:
    aliases:
    - slave_mode
    choices:
    - master
    - replica
    - slave
    default: replica
    description:
    - The mode of the redis instance [replica command]
    - C(slave) is an alias for C(replica).
    type: str

login_password:
    description:
    - The password used to authenticate with (usually not used)
    type: str

See also

• community.general.redis_info