NAME

Rex - Remote Execution

DESCRIPTION

(R)?ex is a small script to ease the execution of remote commands. You can write small tasks in a file named Rexfile.

You can find examples and howtos on http://rexify.org/

GETTING HELP

• Web Site: http://rexify.org/

• IRC: irc.freenode.net #rex

• Bug Tracker: https://rt.cpan.org/Dist/Display.html?Queue=Rex

• Twitter: http://twitter.com/jfried83

Dependencies

• Net::SSH2

• Expect

  Only if you want to use the Rsync module.

• DBI

  Only if you want to use the DB module.

SYNOPSIS

desc "Show Unix version";
task "uname", sub {
    say run "uname -a";
};

bash# rex -H "server[01..10]" uname

See Rex::Commands for a list of all commands you can use.

CLASS METHODS

get_current_connection

This function is deprecated since 0.28! See Rex::Commands::connection.

Returns the current connection as a hashRef.

server

The server name

ssh

1 if it is a ssh connection, 0 if not.

is_ssh

Returns 1 if the current connection is a ssh connection. 0 if not.

is_sudo

Returns 1 if the current operation is executed within sudo.

get_sftp

Returns the sftp object for the current ssh connection.

connect

Use this function to create a connection if you use Rex as a library.

use Rex;
use Rex::Commands::Run;
use Rex::Commands::Fs;
  
Rex::connect(
   server      => "remotehost",
   user        => "root",
   password    => "f00b4r",
   private_key => "/path/to/private/key/file",
   public_key  => "/path/to/public/key/file",
);
   
if(is_file("/foo/bar")) {
   print "Do something...\n";
}
    
my $output = run("upime");

CONTRIBUTORS

Many thanks to the contributors for their work (alphabetical order).

Alexandr Ciornii

Anders Ossowicki

Chenryn

Dominik Danter

Dominik Schulz

Gilles Gaudin, for writing a french howto

Hiroaki Nakamura

Jean Charles Passard

Jeen Lee

Joris

Jose Luis Martinez

Laird Liu

Nikolay Fetisov

Samuele Tognini

Sascha Guenther

Sven Dowideit

Tomohiro Hosaka