Redis

Роль Redis, которая может быть использована для создания различных настроек Redis:

• одиночный узел
• одиночный главный узел с несколькими репликами
• кластер Redis

Большая часть работы основана на уже существующей роли: DavidWittman.redis

Список задач

• добавить конфигурацию Sentinel
• добавить поддержку дополнительных ОС

Установка

ansible-galaxy install BostjanBozic.redis

Начало работы

Роль используется для создания различных настроек Redis. Роль необходимо запускать с правами sudo на удаленных машинах.

Один узел Redis

Развертывание одиночного узла Redis требует использования этой роли без необходимости изменения переменных. Это пример плейбука с указанным портом, на котором будет работать Redis:

---

- hosts: all
  become: yes
  roles:
    - BostjanBozic.redis
  vars:
    - redis_port: 6380

После того как файлы плейбука и инвентаря заданы (например, playbook.yml и inventory), вы развертываете Redis с помощью следующей команды:

ansible-playbook -i inventory playbook.yml

Один главный узел с репликацией

Redis поддерживает настройку репликации, где один главный узел поддерживается одним или несколькими репликационными узлами. Пример ниже разворачивает одну главную инстанцию Redis с 2 репликами:

Файл инвентаря:

[master]
redis-master-0.example.io

[replica]
redis-replica-0.example.io master_host=redis-master-0.example.io
redis-replica-1.example.io master_host=redis-master-0.example.io

Файл плейбука:

---

- hosts: master
  become: yes
  roles:
    - BostjanBozic.redis

- hosts: replica
  become: yes
  roles:
    - BostjanBozic.redis
  vars:
    - redis_replicaof: "{{ master_host }} {{ redis_port }}"

Примечание: репликация и кластерные узлы исключают друг друга. При использовании переменной replicaof, не устанавливайте переменную redis_cluster_enabled.

Режим кластера

Redis также поддерживает режим кластера, в котором данные распределяются между несколькими главными узлами, которые могут поддерживаться одной или несколькими репликационными узлами. Пример ниже разворачивает 3 главные инстанции Redis с 1 репликационным узлом каждая:

Файл инвентаря:

[master]
redis-master-[0:2].example.io

[replica]
redis-replica-0.example.io master_host=redis-master-0.example.io
redis-replica-1.example.io master_host=redis-master-1.example.io
redis-replica-2.example.io master_host=redis-master-2.example.io

Файл плейбука:

---

- hosts: all
  become: yes
  roles:
    - BostjanBozic.redis
  vars:
    - redis_cluster_enabled: "yes"

Примечание: репликация и кластерные узлы исключают друг друга. При использовании переменной redis_cluster_enabled, не устанавливайте переменную replicaof.

Переменные роли

Это список переменных по умолчанию. Для описания, пожалуйста, проверьте официальную документацию.

## Установка
redis_version: 5.0.4
redis_install_dir: /opt/redis
redis_download_url: "http://download.redis.io/releases/redis-{{ redis_version }}.tar.gz"

redis_user: redis
redis_group: redis

redis_nofile_limit: 16384
redis_oom_score_adjust: 0

redis_master_list: "{{ groups['master'] | map('extract', hostvars, ['ansible_default_ipv4', 'address']) | arraypermute( [':'] ) | arraypermute( [ redis_port ] ) }}"

## Служба Redis
redis_as_service: true
redis_service_name: "redis_{{ redis_port }}"

## Конфигурация Redis
# Сетевые параметры
redis_bind: 0.0.0.0
redis_protected_mode: "no"
redis_port: 6379
redis_tcp_backlog: 511
redis_timeout: 0
redis_tcp_keepalive: 300

# Общая конфигурация
redis_daemonize: "yes"
redis_supervised: "no"
redis_pidfile: /var/run/redis/{{ redis_port }}.pid
redis_loglevel: notice
redis_logfile: /var/log/redis_{{ redis_port }}.log
redis_databases: 16

# Конфигурация снимков
redis_save:
  - 900 1
  - 300 10
  - 60 10000
redis_stop_writes_on_bgsave_error: "yes"
redis_rdbcompression: "yes"
redis_rdbchecksum: "yes"
redis_dbfilename: dump.rdb
redis_dir: /var/lib/redis/{{ redis_port }}

# Конфигурация репликации
redis_replicaof: false
redis_replica_serve_stale_data: "yes"
redis_replica_read_only: "yes"
redis_repl_diskless_sync: "no"
redis_repl_diskless_sync_delay: 5
redis_repl_disable_tcp_nodelay: "no"
redis_repl_backlog_size: false
redis_replica_priority: 100
redis_min_replicas_to_write: 0
redis_min_replicas_max_lag: 10

# Конфигурация безопасности
redis_password: false

# Конфигурация клиентов
redis_maxclients: 10000

# Конфигурация управления памятью
redis_maxmemory: false
redis_maxmemory_policy: noeviction

# Конфигурация ленивого освобождения
redis_lazyfree_lazy_eviction: "no"
redis_lazyfree_lazy_expire: "no"
redis_lazyfree_lazy_server_del: "no"
redis_replica_lazy_flush: "no"

# Конфигурация режима только добавления
redis_appendonly: "no"
redis_appendfilename: "appendonly.aof"
redis_appendfsync: everysec
redis_no_appendfsync_on_rewrite: "no"
redis_auto_aof_rewrite_percentage: 100
redis_auto_aof_rewrite_min_size: 64mb
redis_aof_load_truncated: "yes"

# Конфигурация Lua-скриптов
redis_lua_time_limit: 5000

# Конфигурация кластера Redis
redis_cluster_enabled: "no"
redis_cluster_config_file: nodes-{{ redis_port }}.conf
redis_cluster_node_timeout: 15000

# Конфигурация медленного лога
redis_slowlog_log_slower_than: 10000
redis_slowlog_max_len: 128

# Конфигурация монитора задержек
redis_latency_monitor_threshold: 0

# Конфигурация уведомлений о событиях
redis_notify_keyspace_events: '""'

# Конфигурация для продвинутых настроек
redis_client_output_buffer_limit_normal: 0 0 0
redis_client_output_buffer_limit_replica: 256mb 64mb 60
redis_client_output_buffer_limit_pubsub: 32mb 8mb 60

Лицензия

Этот проект лицензирован под лицензией MIT