NAME

Message::Passing::PSGI - ALPHA QUALITY PSGI adaptor for Message::Passing

SYNOPSIS

# Run the server - note that the -e has to all be on one line!
plackup -E production -s Twiggy -MPlack::App::Message::Passing -e'Plack::App::Message::Passing->new(return_address => "tcp://127.0.0.1:5555", send_address => "tcp://127.0.0.1:5556")->to_app'

# Run your app with the handler
plackup -E production -s Message::Passing testapp.psgi --host 127.0.0.1 --port 5556

# Browse to:
http://localhost:5000/

DESCRIPTION

ALPHA QUALITY EXPERIMENT - YOU HAVE BEEN WARNED!

This module implements a mongrel2 like strategy for web handlers, using Message::Passing::ZeroMQ.

WHY

Because I could! It's a useful experiment to prove that Message::Passing can be used for things entirely unlike my initial goals.

NO, REALLY?

Theoretically, this is quite an interesting model - as you've totally split the front end connection acceptance and the back end request handling, you can do things which are harder in other server environments trivially.

Examples of things that 'just work' include:

Adding more handler processes

Totally dynamic, run as many as you want

Adding handler processes on other servers

As long as your send/return sockets are bound to a host that's network accessible, you can spin up handlers wherever you want.

Upgrade the application in production

You can spin up a new version, verify it appears to be working correctly etc before shutting down the old version

Profile the application in production

Just run a handler with NYTProf..

NOTE: The properties above _do not_ exist in the current code - you will drop requests in-flight if you shut handlers down!! (Patches to fix this should not be that hard, and would be welcome if anyone is interested)

If you're actually interested in using this in production, I'd recommend you look at the real mongrel2, and Plack::Handler::Mongrel2.

BUGS

Many, and varied. Please do not try to run this in production ;_)

Issues include:

Large responses will use SEVERAL times the response length in RAM

Requests never timeout

App Handler crashes / restarts will lost in-flight requests.

Quite probably leaks RAM.

This has not been tested, which means I quite probably got it wrong somewhere ;)

SEE ALSO

Plack::App::Message::Passing.

Plack::Handler::Message::Passing.

mongrel2

Message::Passing

Message::Passing::ZeroMQ.

AUTHOR

Tomas Doran (t0m) <bobtfish@bobtfish.net>

COPYRIGHT

Copyright the above author.

LICENSE

GNU Affero General Public License, Version 3

If you feel this is too restrictive to be able to use this software, please talk to us as we'd be willing to consider re-licensing under less restrictive terms.