Giter VIP home page Giter VIP logo

gefyra's Introduction

gefyra - a redis bridge for channels and lists

  • Forwards messages from one (or more) channels/lists to one (or more) other channels/lists
  • Channels/lists can be on same or different Redis servers
  • Simple configuration
  • Lightweight, efficient, written in Go

Quickstart

You can install the native binary for your operating system or use the Docker container.

See example configurations.

Option 1: Install using Homebrew

Install:

brew tap outofcoffee/gefyra
brew install gefyra

Run:

export BRIDGE_CONFIG=./examples/channel_fan_out.yaml gefyra

Option 2: Run using Docker

docker run --rm -it -v /path/to/config/dir:/opt/gefyra/config outofcoffee/gefyra

Supported modes

The following objects can be bridged:

Upstream object Downstream object Same server? Different server?
pubsub channel pubsub channel Yes Yes
pubsub channel list Yes Yes
list pubsub channel Yes Yes
list list Yes Yes

Build and run

Build and run:

docker-compose up --build

For other architectures, see the multiarchitecture documentation.

You should see something similar to the following:

loading config file: /etc/gefyra/config/one_up_one_down.yaml
loaded 1 upstream(s) and 1 downstream(s)
connecting to upstreams
initialising redis connection to upstream:6379
checking redis connection [attempt #1]...
redis connected at upstream:6379
connecting to downstreams
initialising redis connection to downstream:6379
checking redis connection [attempt #1]...
redis connected at downstream:6379
starting bridge upstream:6379/chan->downstream:6379/chan

Test

If you've started the example using Docker Compose (above), then you can test by sending a message to the upstream and seeing it propagate downstream.

Subscribe to downstream:

docker run --rm -it --network gefyra_redis bitnami/redis:4.0 redis-cli \
  -h downstream \
  -a password \
  SUBSCRIBE output-chan

Publish from upstream:

docker run --rm -it --network gefyra_redis bitnami/redis:4.0 redis-cli \
  -h upstream \
  -a password \
  PUBLISH input-chan hello

gefyra, γέφυρα, is Greek for 'bridge'.

gefyra's People

Contributors

outofcoffee avatar snyk-bot avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.