seekasia/redis repository overview

⁠About

This repository contains files to create Docker image for Redis⁠ from Official Redis Image⁠ with support for Redis cluster.

The image/packages used are pinned to a version number in the Dockerfile to ensure image stability.

Automated builds of the image are available on the Docker Hub⁠.

⁠Usage

To start a Redis instance:

docker run --name <container-name> -d seekasia/redis:<tag>

Additionally if you want to mount the data directory or specifying the custom configuration file:

docker run \
--net=host \
-v <data-dir>:/data \
-v <logrotate-conf>:/etc/logrotate.d/redis \
-v <redis-conf>:/usr/local/etc/redis/redis.conf \
--name <container-name> -d seekasia/redis:<tag> \
redis-server /usr/local/etc/redis/redis.conf

Docker's networking layer affects the performance significantly, if possible, run the container with --net=host to use host networking to improve the throughput as shown above.

This also a proposed solution for running Redis cluster from different hosts where the Docker's internal address unreachable by other Redis nodes in the cluster.

⁠Timezone

You can use the environment variable to modify the timezone in the container (Default to Asia/Singapore):

-e TZ=<timezone>

⁠redis-trib

The Ruby utility used to facilitate Redis cluster administration is called redis-trib-pass.rb, an enhanced version of the redis-trib.rb with added support for authentication.

Run any redis-trib command as follow:

redis-trib-pass.rb help
redis-trib-pass.rb create --auth <password> 192.168.11.11:7001 192.168.11.11:7002 192.168.11.11:7003