etcd-netfw is a dynamic TCP proxy (net forwarder) which configuration is based on etcd. It provides real time dynamic reconfiguration of destination hosts and is able to do some load balancing.

It is part of the nuxeo.io infrastructure.

It is a TCP proxy which fetch its configuration from etcd. The configuration format is the following. Let's says the servicePath parameter is set to /services/postgres/ and given the following etcd values :

/services/postgres/1/location: {"host": "172.31.51.34", "port": 5432}
/services/postgres/2/location: {"host": "172.31.51.35", "port": 5432}

Then, when asking for a connection to etcd-netfw, it will forward alternatively to the first and second host.

Several parameters allow to configure the way the proxy behave :

• acceptAddr allows to setup a listening address (0.0.0.0/1337 by default)
• etcdAddress address of a list of etcd nodes (coma separated)
• servicePath : path of the key where the service instances are resistered.

etcd-netfw is used in nuxeo.io to build dynamic Docker ambassadors. A small explanation can be found here : https://github.com/nuxeo/nuxeo.io-scripts/tree/master/docker/service-amb

We use GOM to build.

go get github.com/mattn/gom
gom install

We are glad to welcome new developers on this initiative, and even simple usage feedback is great.

• Ask your questions on Nuxeo Answers
• Report issues on this github repository (see issues link on the right)
• Contribute: Send pull requests!

Nuxeo provides a modular, extensible Java-based open source software platform for enterprise content management, and packaged applications for document management, digital asset management and case management.

Designed by developers for developers, the Nuxeo platform offers a modern architecture, a powerful plug-in model and extensive packaging capabilities for building content applications.

More information on: http://www.nuxeo.com/