[ANN] lua-resty-upstream - TCP connection load balancing and failover

hamish.forbes · 2014-01-16T20:50:47+00:00

Thanks! I did see the check there but didnt realize it was meant just for this.On Wednesday, 15 January 2014 09:52:18 UTC+5:30, agentzh wrote:Hello! On Tue...

[ANN] lua-resty-upstream - TCP connection load balancing and failover

hamish.forbes

Hi All,

I've been working on a module to allow load balancing and failover for the ngx.socket.tcp api with dynamically configurable pools of hosts.

The aim is to provide similar, or better, functionality compared to the nginx upstream and proxy modules but in pure lua.

https://github.com/hamishforbes/lua-resty-upstream

I've also created a wrapper for James Hurst's lua-resty-http (https://github.com/pintsized/lua-resty-http) module,

providing nearly the same interface as lua-resty-http but with failover based on HTTP response status codes as well as socket connection failures.

The repo contains an example http load balancer / proxy config, which in initial testing performs at least as well as the native nginx upstream and proxy modules.

Currently only random round-robin load balancing has been implemented as we have no real world use for sticky sessions,

however sticky sessions are planned as a future feature along with active health checks (both HTTP and TCP).

It's possible to pass in any of the lua-resty-* modules which implement connect and set_keepalive,

this gives you connection load balancing and failover for lua-resty-redis, lua-resty-memcached etc etc.

Any suggestions, thoughts or criticisms are most welcome!

Thanks

Hamish

brian

Very nice! I've written a few versions of such things for projects, so it should be good to have a general use one in the community.

louie.kwan

I am looking for a module to allow TCP load balancing for a while as well. Have you taken a look at the following:

https://github.com/yaoweibin/nginx_tcp_proxy_module

You mentioned about a wrapper, how can we access it?

Can you share more what should be done to get lua support with openresty to get dynamic backend configuration without going to the Nginx Plus path?

Thanks.

Louie

On Thursday, 16 January 2014 07:50:46 UTC-5, Hamish Forbes wrote:

Hi All,

I've been working on a module to allow load balancing and failover for the ngx.socket.tcp api with dynamically configurable pools of hosts.
The aim is to provide similar, or better, functionality compared to the nginx upstream and proxy modules but in pure lua.

https://github.com/hamishforbes/lua-resty-upstream

I've also created a wrapper for James Hurst's lua-resty-http (https://github.com/pintsized/lua-resty-http) module,
providing nearly the same interface as lua-resty-http but with failover based on HTTP response status codes as well as socket connection failures.
The repo contains an example http load balancer / proxy config, which in initial testing performs at least as well as the native nginx upstream and proxy modules.

Currently only random round-robin load balancing has been implemented as we have no real world use for sticky sessions,
however sticky sessions are planned as a future feature along with active health checks (both HTTP and TCP).

It's possible to pass in any of the lua-resty-* modules which implement connect and set_keepalive,
this gives you connection load balancing and failover for lua-resty-redis, lua-resty-memcached etc etc.

Any suggestions, thoughts or criticisms are most welcome!

Thanks
Hamish