Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/emeric-martineau/redis-concentrator
Redis Concentrator is tool to easly connect your application to Redis without know his infrastructure.
https://github.com/emeric-martineau/redis-concentrator
Last synced: 16 days ago
JSON representation
Redis Concentrator is tool to easly connect your application to Redis without know his infrastructure.
- Host: GitHub
- URL: https://github.com/emeric-martineau/redis-concentrator
- Owner: emeric-martineau
- License: apache-2.0
- Created: 2019-08-15T14:58:53.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-07-25T17:08:03.000Z (6 months ago)
- Last Synced: 2024-11-06T00:16:33.872Z (2 months ago)
- Language: Rust
- Size: 136 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# RedConcentrator
[]()
[](https://github.com/emeric-martineau/redis-concentrator/issues)
[](https://github.com/emeric-martineau/redis-concentrator/pulls)
[](/LICENSE)
---
## About RedConcentrator
**RedConcentrator** provide an easy way to connect to Redis Master/Slave or to Redis Cluster (comming soon).
When you want to connect to Redis you must check if your library support Redis mode. For example [php-redis](https://github.com/phpredis/phpredis) don't provide support of master/slave. With **RedConcentrator** you can connect you PHP application to Redis master/slave just by giving **RedConcentrator** ip-port.
## Getting Started RedConcentrator
These instructions will get you a copy of the project up and running on your local machine.
### Prerequisites
To use **RedConcentrator** no prerequisites need.
### Installing and running
Just get binary from [GitHub release repository](https://github.com/emeric-martineau/redis-concentrator/releases) and put it in somewhere what you want.
After, create a [YAML](https://yaml.org/) file like below:
```
bind: 127.0.0.1:6578
group_name: "cluster_1"
sentinels:
- 127.0.0.1:26000
- 127.0.0.1:26001
- 127.0.0.1:26002
log:
type: console
level: info
```
And run
```
redis-concentrator ./my_config_file.yaml
```
Now, set you client to connect your **RedConcentrator** server.
```
./redis-cli -p 6578
127.0.0.1:6578> INFO
# Server
redis_version:5.0.0
redis_git_sha1:00000000
redis_git_dirty:0
...
# Keyspace
db0:keys=1,expires=0,avg_ttl=0
(2.88s)
127.0.0.1:6578>
```
See [redis-concentrator-config.yaml.sample](./redis-concentrator-config.yaml.sample) for more options.
### How it's works.
**RedConcentrator** has one process and two threads.
First thread wait client connection.
Second thread connect to Redis sentinel to know if master change.
The main process copy data from/to client to/from Redis master.
---
## Contributing
Contributions, issues and feature requests are welcome!
Feel free to check [issues page](https://github.com/emeric-martineau/redis-concentrator/issue).
### Prerequisites
To build **RedConcentrator** you only need [Rust](https://www.rust-lang.org) 1.78.0 (maybe build with older version) and [rustfmt](https://github.com/rust-lang/rustfmt) package.
### Build
You need install `pkg-config` and `libssl-dev` under Linux.
Just run:
```
$ cargo build --release
```
### Running the tests RedConcentrator
Just run:
```
$ cargo test
```
### Coding style
Code style is formatted by `rustfmt`.
---
## Built Using RedConcentrator
- [Rust](https://www.rust-lang.org) - Language
- [Redis](https://redis.io) - Database
## Authors RedConcentrator
- [emeric-martineau](https://github.com/emeric-martineau) - Idea & Initial work
---
## License
Copyright © MARTINEAU Emeric [emeric-martineau](https://github.com/emeric-martineau) .
This project is Apache 2 licensed.