React
React is a simple application that allows for remote execution of commands, and it uses Redis as a queue.
Inspiration
It's inspired by Simon Willison's example of "Queue-activated shell scripts" in his redis tutorial:
while [ 1 ] do
redis-cli blpop restart-httpd 0
apache2ctl graceful
done
Installation
You can simply install React using rubygems:
sudo gem install react
Usage
Firs you have to prepare file with available commands. It can look like this:
# my_commands.yml
restart_httpd: apache2ctl graceful
restart_mysql: /etc/init.d/mysql restart
reboot: reboot
And now you can start a consumer.
react my_commands.yml
Pushing commands
While your consumer is working, you can push any of specified command to
queue (default queue name is queue
), eg:
redis-cli lpush queue restart_httpd
redis-cli lpush queue reboot
After that consumer will pick up enqueued command names from and execute related commands.
Configuration
There are few more runtime options, which can be useful for you.
-
you can specify queue which will be consumed:
react my_commands.yml --queue "my:queue:name"
-
you can specify the database to which consumer should connect:
react my_commands.yml --host "yourhost.com" --port 6379 --db 2 --password pass
-
and finally, you can demonize the consumer:
react my_commands.yml --daemon
Note on Patches/Pull Requests
- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don't break it in a future version unintentionally.
- Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
- Send me a pull request. Bonus points for topic branches.
Copyright
== Copyright
Copyleft 2010 Chris Kowalik. WTFPL Baby!
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
- You just DO WHAT THE FUCK YOU WANT TO.