computer-playbook/roles/docker-redis/README.md

Role: docker-redis

Description

This Ansible role provides a Jinja2 snippet to inject a Redis service definition into your Docker Compose setup. It renders a service.yml.j2 template that defines a redis container with sensible defaults.

Overview

The role’s service.yml.j2 template includes:

• An Alpine-based Redis image (redis:alpine)

• Container naming based on application_id (defaults to redis)

• Restart policy

• Journald logging driver

• A named volume (redis:/data) for persistence

• A basic healthcheck using redis-cli ping

• Attachment to the default network

Include this snippet in your top-level docker-compose.yml.j2 where you want Redis to appear.

Features

• Configurable application_id
  Sets container name ({{ application_id }}-redis).

• Restart policy
  Controlled by docker_restart_policy.

• Journald logging
  Ensures logs are captured by systemd’s journal.

• Persistent storage
  Declares and mounts redis:/data.

• Built-in healthcheck
  Uses redis-cli ping with configurable intervals and retries.

Further Resources

• Official Redis Docker image on Docker Hub
• Ansible Jinja2 documentation
• Docker Compose reference