(R)?ex the friendly automation framework

News

2023-08-05
Rex-1.14.3

Rex-1.14.3 is now available on CPAN. It contains bug fixes for local package installation, command existence checks, and Git tests.

2023-05-05
Rex-1.14.2

The Rex-1.14.2 release is now available on CPAN. It contains bug fixes for running local commands on Windows, cloning git repositories, and test suite fixes for the upcoming perl-5.38.0 release.

2023-03-17
Call for papers TPRC 2023

Dean Hamstead from the The Perl and Raku Foundation Marketing Committee has sent an invitation to present about Rex at TPRC 2023. I’m posting it here to increase visibility.

2023-03-05
Rex-1.14.1

The Rex-1.14.1 release is now available on CPAN. It contains bug fixes and documentation updates.

2023-02-05
Rex-1.14.0

The Rex-1.14.0 release is now available on CPAN. It contains improved Rexfile loading, documentation updates, and bumps the minimum required Perl version to 5.12.5.

Events

2021-03-08
Learning automation using Rex

Ferenc Erki (FErki) will be the guest of Gábor Szabó on the next Code Maven live stream to learn about automation using Rex. Register for the free event via Code Maven or Meetup, and join the discussion!

2020-03-05
Unexpected use cases with Rex

Unexpected use cases with Rex at the 22nd German Perl/Raku Workshop 2020 in Erlangen by Ferenc Erki (FErki).

2019-11-09
Rex & Friends

Rex & Friends talk at the Barcelona Perl & Friends 2019 by Ferenc Erki (FErki).

» Home » Docs » Release notes » Release notes for 0.42

Release notes for 0.42

Common

Net::OpenSSH connection mode - chenryn

As of this release it is possible to use Net::OpenSSH for the connection. With this it is also possible to use kerberos authentication and all features OpenSSH has (like ProxyCommand, etc.).

To use Net::OpenSSH you have to set the connection type in your Rexfile.

This fixes long standing pull request #70.

use Rex -feature => '0.42';

set connection => 'OpenSSH';

task 'yourtask', 'yourserver', sub {
    say run 'uptime';
};

Kerberos authentication - chenryn

If you want to use kerberos authentication you have to use Net::OpenSSH.

set connection => "OpenSSH";

user "youruser";
krb5_auth;

Custom user for sudo command

It is now possible to use custom users for the sudo command.

task "mytask", "server1", sub {
    sudo {
        user    => "foo",
        command => "id",
    };
};

new function delete_lines_according_to - liedekef

This function is similar to delete_lines_matching but with an other syntax and the possibility to use the on_change hook if the file was changed.

task "cleanup", "server1", sub {
    delete_lines_according_to qr{^foo:}, "/etc/passwd", on_change => sub {
        say "removed user foo.";
    };
};

new feature flag use_server_auth to enable auth properties in INI files

define server groups with special server properties in INI files

The INI file feature is improved to allow custom properties for servers and to allow inheritance of sections.

You have to use use_server_auth feature flag for this.

# Rexfile
use Rex -feature => [qw/use_server_auth/];
use Rex::Group::Lookup::INI;
groups_file('servergroups.ini');
; my group file
[frontends]
fe01
fe02

fe03
fe04
fe05

# the backends
[backends]
be01
be02
;be03
be04

[db]
db[01..02]

[redis]
@backends
redis01
redis02

[memcache < redis]
memcache01
memcache02 user=root password=foob4r sudo=true services=apache,memcache

This will create the following groups:

frontends: fe01, fe02, fe03, fe04, fe05
backends: be01, be02, be04
db: db01, db02
redis: be01, be02, be04, redis01, redis02
memcache: be01, be02, be04, redis01, redis02, memcache01, memcache02

memcache02 will use custom authentication and there will be a special option "services" for this server that can be queried like this:

task "mytask",
  group => "memcache",
  sub {
    say connection->server->option("services");
  };

cwd option for run command

run "ls -l", cwd => "/home";

Speed improvements

Bugfixes/cleanups/enhancements

Proudly powered by Perl and built with Statocles

GitHub repository and discussions / Chat on Matrix and IRC / Mailing list on Google Groups (retired: rex-users@freelists)

MetaCPAN / Twitter / StackShare / Server Fault   -.ô.-   Disclaimer