From 16491198b3ba4723d94f959f101c138592af9f12 Mon Sep 17 00:00:00 2001
From: Stonewall Jackson <stonewall@sacredheartsc.com>
Date: Sun, 19 Feb 2023 20:44:23 -0500
Subject: redis: add docs

---
 roles/redis/README.md | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 roles/redis/README.md

(limited to 'roles')

diff --git a/roles/redis/README.md b/roles/redis/README.md
new file mode 100644
index 0000000..8017bb2
--- /dev/null
+++ b/roles/redis/README.md
@@ -0,0 +1,42 @@
+Redis
+=====
+
+Description
+-----------
+
+The `redis` role configures a local Redis instance on the specified port.
+The database will be stored in `/var/lib/redis/$PORT`, so it's possible to run
+multiple redis instances on the same host.
+
+
+Variables
+---------
+
+This role **accepts** the following variables:
+
+Variable                  | Default       | Description
+--------------------------|---------------|------------
+`redis_port`              | 6379          | Local listening port
+`redis_max_memory`        | `2gb`         | Memory usage limit before eviction
+`redis_max_memory_policy` | `allkeys-lru` | Eviction policy
+
+This role **exports** the following variables:
+
+Variable     | Description
+-------------|------------
+`redis_home` | Path to redis data directory
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- name: install redis
+  hosts: test1
+  roles:
+    - role: redis
+      vars:
+        redis_port: 6379
+        redis_max_memory: 2g
+````
-- 
cgit