feat(redis): add ansible role

README.md

@@ -4,5 +4,9 @@
 
 - [`elasticsearch`](roles/elasticsearch/README.md): deploy
   elasticsearch (OSS) in a docker container
+
+- [`redis`](roles/redis/README.md): deploy and configure redis,
+  a fast cache, vector search and NoSQL database.
+
 - [`mariadb`](roles/mariadb/README.md): deploy mariadb
   in a docker container

galaxy.yml

@@ -14,5 +14,6 @@ repository: https://git.finally.coffee/finallycoffee/databases
 issues: https://codeberg.org/finallycoffee/ansible-collection-databases/issues
 tags:
   - elasticsearch
+  - redis
   - mariadb
   - docker

roles/redis/README.md

@@ -37,3 +37,11 @@ redis_container_volumes:
   - "/path/to/socket/on/host/redis.sock:{{ redis_container_socket }}:z"
 redis_config_unixsocket: "{{ redis_container_socket }}"
 ```
+
+## Container specific information
+
+Redis publishes their official container image in both a debian-based and an
+alpine-based variant. Which image should be used can be configured in
+`redis_container_image_flavour`, which defaults to `alpine`, which is smaller
+in size but also includes less related / debugging tools. To use the debian-
+based image, unset the flavour using `redis_container_image_flavour: ~`.

roles/redis/defaults/main/config.yml

@@ -30,8 +30,8 @@ redis_base_config:
   appendfsync: "{{ redis_config_appendfsync }}"
 
 redis_config: ~
-redis_config_merged: >-2
-  {{ redis_config_base
+redis_merged_config: >-2
+  {{ redis_base_config
   | combine(({
       'unixsocket': redis_config_unixsocket,
       'unixsocketperm': redis_config_unixsocketperm,

roles/redis/defaults/main/container.yml

@@ -17,7 +17,8 @@ redis_container_image: >-2
     + ':' +
     (redis_container_image_tag | default(
       redis_version + (
-        (redis_container_image_flavour | default(false, true) | bool)
+        ((redis_container_image_flavour is string)
+            and (redis_container_image_flavour | length > 0))
         | ternary('-' + (redis_container_image_flavour | default('')), '')
       ),
       true,
@@ -42,7 +43,7 @@ redis_container_etc_hosts: ~
 redis_container_dns_servers: ~
 redis_container_restart_policy: "unless-stopped"
 redis_container_state: >-2
-  {{ (redis_state == 'present') | default('started', 'absent') }}
+  {{ (redis_state == 'present') | ternary('started', 'absent') }}
 redis_container_base_volumes:
   - "{{ redis_config_file }}:{{ redis_config_file }}:ro"
   - "{{ redis_data_path }}:{{ redis_data_path }}:rw"

roles/redis/defaults/main/main.yml

@@ -1,9 +1,10 @@
 ---
 redis_version: "7.2.4"
+redis_state: "present"
 redis_instance: ~
 redis_instance_suffix: >-2
-  {{ (redis_instance | default(false, true) | bool)
-    | ternary('-' + (redis_instance | default('')), '') }}
+  {{ ((redis_instance is string) and (redis_instance | length > 0))
+    | ternary('-' + (redis_instance | default('', true)), '') }}
 redis_user: >-2
   redis{{ redis_instance_suffix }}
 

roles/redis/handlers/main.yml

@@ -6,5 +6,6 @@
     restart: true
   listen: redis-restart
   when:
-    - deployment_method == 'docker'
+    - redis_deployment_method == 'docker'
     - redis_state == 'present'
+  ignore_errors: "{{ ansible_check_mode }}"

roles/redis/tasks/main.yml

@@ -48,13 +48,13 @@
   ansible.builtin.copy:
     content: |+2
       {% for tuple in (redis_merged_config | dict2items) %}
-      {%- if tuple.value is string -%}
+      {% if tuple.value is string  or tuple.value is number %}
       {{ tuple.key }} {{ tuple.value }}
-      {%- elsif -%}
+      {% else %}
       {% for value in tuple.value %}
       {{ tuple.key }} {{ value }}
       {% endfor %}
-      {%- endif -%}
+      {% endif %}
       {% endfor %}
     dest: "{{ redis_config_file }}"
     owner: "{{ redis_run_user_id }}"