Skip to main content

Redis Cluster Management Tool

Project description

# redis-clu
Redis Cluster Management Tool

Create/Manage sharded+replicated redis cluster easily.

# Installation

```bash
pip install redis-clu
```

# Usage

##### Create cluster

```bash
# Sharded cluster (master-master)
redis-clu create localhost:6376 localhost:6377 localhost:6378
```


##### Show status

```bash
redis-clu status localhost:6376
```


##### Add masters

```bash
# single node:
redis-clu add localhost:6379
(optional: --keyMigrationCount <count> ) pipelined command, default 1

# multiple nodes:
# recommended for dynamic scaling, it will be split cluster into subclusters
# and each subcluster will be resharding simultaneously
# <cluster> <masters>
redis-clu add_multi localhost:6376 localhost:6381 localhost:6382
(optional: --keyMigrationCount <count> ) pipelined command, default 1
```


##### Add slaves

```bash
# master-slave replication
# To make redis cluster high available, all master should have at least one slave.
# <master> <slave>
redis-clu replicate localhost:6376 localhost:6385
```


##### Fix cluster

```bash
redis-clu fix localhost:6376
# If occurs "Slot <slot> is already busy" execute with "--force 1"
redis-clu fix localhost:6376 --force 1
```


##### Reshard cluster (Slot balancing)

```bash
redis-clu reshard localhost:6376
(optional: --keyMigrationCount <count> ) pipelined command, default 1
```


##### Remove node

```bash
# <cluster> <node(master or slave)>
redis-clu remove localhost:6376 localhost:6380
(optional: --keyMigrationCount <count> ) pipelined command, default 1
```


##### Flush/Destroy cluster

```bash
# flush cluster (initialize with 0 keys):
redis-clu reset localhost:6376

# destroy cluster:
redis-clu reset localhost:6376 --hard 1
```


# Monitoring

Also you can make your own basic monitoring screen using 'watch'.

brew install watch (For Mac OSx)
redis-clu status <cluster_node>
watch -d -n 1 'redis-clu status localhost:6376'

Monitoring will help you to make an action.

![ScreenShot](https://raw.github.com/baranbartu/redis-clu/master/screenshot.png)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for redis-clu, version 0.0.7
Filename, size File type Python version Upload date Hashes
Filename, size redis-clu-0.0.7.tar.gz (11.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page