» Home
Why use Rex?
If you have to do a task more than once, automate it!
Don‘t forget an installation step anymore. Automation reduces the risk of failure and let you do your real work.
Advantages
- Uses ssh, no agent required
- Seamless integration, no conflicts
- Easy to use and to extend
- Easy to learn, it‘s just plain Perl
Open source
We believe in the idea of open source. So Rex, and all its parts are released under the Apache 2.0 license.
You‘re invited to join the community to make Rex better and better.
Uptime?
This command line example will execute uptime on all the given hosts (frontend01, frontend02, ...)
$ rex -H "frontend[01..15]" -e "say run 'uptime'"The same, but with a Rexfile
use Rex -feature => ['1.0'];
desc "Get Uptime";
task "uptime", sub {
say run "uptime";
};Now you can run your task with this command:
$ rex -H "frontend[01..15] middleware[01..05] db[01..04]" -u ssh-user -p ssh-password uptimeKeep Your Configuration In Sync
This example will install the Apache webserver on 5 machines and keep their configuration in sync. If the deployed configuration file changes, it will automatically reload the service.
If this task gets executed against a "virgin" host (where no Apache is installed yet), it will first install it.
use Rex -feature => ['1.0'];
user "root";
group frontend => "frontend[01..05]";
desc "Prepare Frontend Server";
task "prepare", group => "frontend", sub {
pkg "apache2",
ensure => "latest";
service "apache2",
ensure => "started";
};
desc "Keep Configuration in sync";
task "configure", group => "frontend", sub {
prepare();
file "/etc/apache2/apache2.conf",
source => "files/etc/apache2/apache2.conf",
on_change => sub { service apache2 => "reload"; };
};Running under sudo?
You can also run everything with sudo. Just define the sudo password and activate sudo.
use Rex -feature => ['1.0'];
user "ubuntu";
group frontend => "frontend[01..05]";
sudo TRUE;
sudo_password "mysudopw";
desc "Prepare Frontend Server";
task "prepare", group => "frontend", sub {
pkg "apache2",
ensure => "latest";
service "apache2",
ensure => "started";
};
desc "Keep Configuration in sync";
task "configure", group => "frontend", sub {
prepare();
file "/etc/apache2/apache2.conf",
source => "files/etc/apache2/apache2.conf",
on_change => sub { service apache2 => "reload"; };
};