Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/himadieievsv/redis-cluster

Minimalistic Redis Cluster Image for Docker.
https://github.com/himadieievsv/redis-cluster

Last synced: 2 days ago
JSON representation

Minimalistic Redis Cluster Image for Docker.

Awesome Lists containing this project

README

        

# Overview

Minimalistic Redis Cluster Docker Image.

This Docker image provides a Redis Cluster setup based on the official Redis distribution. It is designed to easily deploy a Redis Cluster environment for various use cases. The image has a small footprint in terms of size.

# Build

Run build with Docker build command:
```bash
docker build --build-arg redis_version=7.2.4 -t my-image:tag .
```

# Usage

## Pool from docker hub

To use this Docker image, follow these steps:
1. Pull the Docker image from Docker Hub:
```
docker pull himadieievsv/redis-cluster:latest
```
2. Run the Redis Cluster container:
```
docker run -d -p 7000-7002:7000-7002 himadieievsv/redis-cluster:latest
```

## Cluster generate script parameters

This is list of available parameters with its default values.

| Environment variable | Default |
|----------------------|-----------:|
| `INITIAL_PORT` | 7000 |
| `MASTERS` | 3 |
| `SLAVES_PER_MASTER` | 0 |
| `IP` | 0.0.0.0 |
| `SENTINEL` | false |
| `STANDALONE` | false |
| `BIND_ADDRESS` | 0.0.0.0 |

If the flag `"SENTINEL=true"` is passed there are 3 Sentinel nodes running on ports 5000 to 5002 matching cluster's master instances.
Check the [docker-entrypoint.sh](docker-entrypoint.sh) file for details on how parameters influence cluster setup.

# Version support list
Redis **7.2.x** version:
- [7.2.x versions list](https://hub.docker.com/r/himadieievsv/redis-cluster/tags?page=1&name=7.2.)

Redis **7.0.x** version:
- [7.0.x versions list](https://hub.docker.com/r/himadieievsv/redis-cluster/tags?page=1&name=7.0.)

Redis **6.2.x** version:
- [6.2.x versions list](https://hub.docker.com/r/himadieievsv/redis-cluster/tags?page=1&name=6.2.)

Redis **6.0.x** version:
- [6.0.x versions list](https://hub.docker.com/r/himadieievsv/redis-cluster/tags?page=1&name=6.0.)

### Choosing latest images

- `himadieievsv/redis-cluster:latest` - points to the latest Redis version build.
- `himadieievsv/redis-cluster:7.2` - points to the latest version among available builds for 7.2.x.
- `himadieievsv/redis-cluster:7.0` - points to the latest version among available builds for 7.0.x.
- `himadieievsv/redis-cluster:6.2` - points to the latest version among available builds for 6.2.x.
- `himadieievsv/redis-cluster:6.0` - points to the latest version among available builds for 6.0.x.

# License

This repo is using the MIT LICENSE.

You can find it in the file [LICENSE](LICENSE)

# Credits
Originally inspired by [docker-redis-cluster](https://github.com/Grokzen/docker-redis-cluster)