(R)?ex the friendly automation framework

News

2020-09-05
Rex-1.12.2

The Rex-1.12.2 release is now available on CPAN. It fixes various regressions, as well as bugs around file management. Upgrade is highly recommended for all users.

2020-08-05
Rex-1.12.1

The Rex-1.12.1 release is now available on CPAN. It adds documentation for feature flags, and fixes a release packaging issue.

2020-07-05
Rex-1.12.0

The Rex-1.12.0 release is now available on CPAN. It adds support for local rsync operations, improves tab completion for Bash and Zsh, and fixes related bugs. It also discontinues support for running Rex on Windows 7, Windows Server 2008 R2, and older versions since both mainstream and extended support has already ended for these products.

2020-06-09
Rex on StackShare

Thanks to the support from their amazing team, Rex is now listed on StackShare.

2020-06-05
Rex-1.11.0

The Rex-1.11.0 release is now available on CPAN. It enhances the behaviour of sysctl and file management, fixes bugs about group management and OpenSSH connection options, and clarifies quite a bit of documentation.

Conferences

2016-06-21

Need Help?

Rex is a pure open source project, you can find community support in the following places:

Professional support is also available.

» 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

Google Group / Twitter / GitHub / Mailinglist / irc.freenode.net #rex   -.ô.-   Disclaimer