(R)?ex the friendly automation framework

News

2021-07-05
Rex-1.13.4

The Rex-1.13.4 release is now available on CPAN. It contains documentation updates, and a fix for inconsistent behavior between the content and source options of the file command.

2021-03-05
Rex-1.13.3

The Rex-1.13.3 release is now available on CPAN. It contains documentation updates, and a fix for debconf parsing. Behind the scenes, CI was migrated over to GitHub Actions as well.

2020-12-05
Rex-1.13.2

The Rex-1.13.2 release is now available on CPAN. It contains only documentation updates, mostly for the built-in template capabilities, but also fixes a few typos.

2020-11-05
Rex-1.13.1

Happy 10th birthday, Rex!

The Rex-1.13.1 release is now available on CPAN. It is focusing on CMDB bugfixes and documentation, while also fixing a missing feature flag. Upgrade is recommended for all users.

2020-10-05
Rex-1.13.0

The Rex-1.13.0 release is now available on CPAN. It adds on_no_change hooks for file management commands to trigger further actions when files are left unchanged. Upgrade is recommended for all users.

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 » Guides » Working with packages

Working with packages

If you want to install or remove packages on your server Rex gives you a few functions to do this. Rex tries to guess the right package provider based on the platform Rex connects to. If you want to use a special package provider (for example, if you're using SunOS and want to use OpenCSW) you can define the package provider with package_provider_for $os => $provider_name.

Installing a Package

To install a package you can use the pkg function.

task "prepare", "server1", sub {
    pkg "apache2", ensure => "present";
};

If you want to install multiple packages you can do it by providing an array reference.

task "prepare", "server1", sub {
    pkg [qw/apache2 vim php5/], ensure => "present";
};

If you want to install a special version of a package you just need to specify the version option.

task "prepare", "server1", sub {
    pkg "apache2", ensure => "2.2.4";
};

Removing a Package

If you don't need a package anymore you can remove it with the remove function.

task "prepare", "server1", sub {
    pkg "apache2", ensure => "absent";
};

Adding a Package Repository

Sometimes you have to add custom repositories to your Server. This can be done with the repository function. In the following code block you'll see an example for Debian and CentOS.

Debian

task "prepare", "server2", sub {

    # add a repository for debian/ubuntu
    repository
      add        => "myrepo",
      url        => "http://foo.bar/repo",
      distro     => "squeeze",
      repository => "stable";
};

CentOS

task "prepare", "server2", sub {

    # add a repository for redhat/centos
    repository
      add => "myrepo",
      url => "http://foo.bar/repo";
};

After you've added a new repository you need to run update_package_db to update the package database so that you can install packages from these repositories.

task "prepare", "server2", sub {

    # add a repository for redhat/centos
    repository
      add => "myrepo",
      url => "http://foo.bar/repo";

    # update package database
    update_package_db;
};

Supported Package Providers

Rex supports the following package providers:

Proudly powered by Statocles

GitHub / Matrix / IRC / Twitter / Google Groups / StackShare / Mailing list / Server Fault   -.ô.-   Disclaimer