NAME

Rex::Apache::Deploy - Deploy module for Rex

DESCRIPTION

This is a (R)?ex module to ease the deployments of Tomcat, Perl, Rails, PHP or other languages.

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

GETTING HELP

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

• IRC: irc.freenode.net #rex

DEPENDENCIES

• Rex

• YAML

• LWP::Simple

• zip

• unzip

• tar

• bzip2

• wget

If you're using windows, you can install them from here: http://sourceforge.net/projects/gnuwin32/files/ Don't forget to add the bin directory of the installation to your %PATH% environment variable.

SYNOPSIS

use Rex::Apache::Deploy Symlink;

deploy_to "/var/deploy";

document_root "/var/www/myhost/htdocs";

generate_deploy_directory sub {
   my ($file) = @_;
   $file =~ m/-(\d+\.\d+\.\d+)\.tar\.gz$/;
   return $1;
};

desc "Deploy to Apache";
task "deploy", group => "frontend", sub {
   deploy "mypkg-1.0.1.tar.gz";
};

DEPLOY METHODS

Symlink

This method will upload your package (*.tar.gz, *.tar.bz2 or *.zip) all you servers and extract it in the directory you specified with deploy_to concatenated with the result of generate_deploy_directory. After that it will create a symlink from document_root to this new directory.

deploy_to "/var/deploy";
document_root "/var/www";
generate_deploy_directory sub { return "1.0"; };

This will upload the file to /var/deploy/1.0 and create a symlink from /var/www to /var/deploy/1.0.

Tomcat

This method is for Tomcat deployments. You need to have the Tomcat Manage application running on your Tomcat servers. It will upload your package to /tmp/some-random-chars.war, call the Tomcat Manager to undeploy the current context and deploy the new war archive. After that it will delete the uploaded temporary war file.

context_path "/myapp";

task "deploy", group => "middleware", sub {
    deploy "myapp.war",
        username    => "manager-user",
        password    => "manager-password",
        port        => 8080,
        manager_url =>  "/manager";
};

This will deploy myapp.war to the tomcat listening on port 8080 with the manager application found under http://the-server:8080/manager.

SWITCHING INSTANCES

If you have multiple Tomcat Instances you can manage them with the jk command.

jk disable => 'name';
jk enable  => 'name';