smebberson/alpine-consul-redis repository overview

⁠alpine-consul-redis

A Docker image for running Redis⁠ with Consul⁠, based on Alpine Linux. This image belongs to a suite of images documented here⁠.

Image size is ~50 MB.

⁠Features

This image features:

• Alpine Linux⁠
• s6⁠ and s6-overlay⁠
• Redis⁠
• consul⁠

⁠Versions

• 2.2.0, latest (Dockerfile)⁠
• 2.1.0 (Dockerfile)⁠
• 2.0.0 (Dockerfile)⁠
• 1.0.0 (Dockerfile)⁠

See VERSIONS.md for image contents.⁠

⁠Usage

To use this image include FROM smebberson/alpine-consul-redis at the top of your Dockerfile, or simply docker run --name redis smebberson/alpine-consul-redis.

This container has been setup to automatically connect to a Consul cluster, created with a service name of consul. Read more about it here⁠.

⁠Customisation

This container comes setup as follows:

• Redis will be automatically started for you.
• If Redis dies, so will the container.
• A basic Redis configuration which you can review and customise⁠.

To update the configuration:

• Create a file called redis-local.conf, fill it with all of the config overrides that you require.
• In your Dockerfile, copy this file to /etc/redis-local.conf.

Redis will start and load the config at /etc/redis.conf, and then load /etc/redis-local.conf and apply any overrides.

⁠Consul service registration

This container is automatically configured to register itself with Consul, as the redis service operating on port 6379. It comes with a script /usr/bin/redis-check, that is wired up to a Consul service health check.

Any of these files can be changed in your image, as required to customise the setup.

⁠Example

An example of using this image can be found in examples/user-consul-redis⁠.