/dynx

Dynamic Docker friendly gateway

Primary LanguageLuaApache License 2.0Apache-2.0

dynx

Build Status

Coverage Status

Dynamic Docker friendly gateway

The purpose of the project is to provide a dynamically configurable gateway that is easilly deployable in a docker swarm enviroment.

Requirements:

  • Offer dynamic routing
  • configurable through an easy to use rest api
  • No down time to relad configuration
  • configuration should be shared by all the nodes but no context is shared between nodes (No node to node communication)
  • ...

Current solution:

The current solution use openresty (NGINX based scriptable gateway) with a redis as a Database. It's based on dns The NGINX have 2 servers configured:

  • server listening on 8888 is for configuration and is used to push an upstream to a redis List ( the key is the desired location/API)
  • server listening on 8666 have a wildcard location that will execute a lua (rewrite) script to find the upstream, based on the path and rewrite it to the configured upstream The current solution is based on https://github.com/tes/lua-resty-router

TODO

  • Update the README to add a demo and how to deploy
  • Add the ability to remove a location
  • Add the ability to configure multiple upstream for one location (load balancing)
  • Add a pipeling with tests (specially for LUA scripting)
  • Add the ability to delete all locations
  • Add unit test framework for the lua libraries
  • Write documentation with examples and use cases
  • Add swagger documentation for the API
  • Add an etcd backend support
  • Add regex support for upstream
  • ...

Join the team

Do you want to collaborate? Join the project at https://crowdforge.io/projects/261