cezarion/drush_deploy

Amazee Labs flavoured Edition of Drush Deploy

DRUSH DEPLOY

About

Drush deploy is a deployment framework built on Drush. It is heavily influenced by capistrano.

This project aims to help you deploy your code in a way that will cause minimal/no downtime, and let you easily rollback if problems occur.

This project will not help you deploy content. For that, check out the Deploy module.

USAGE

You define the servers you want to deploy to using drush site alias groups. For example, you could put the folowing in ~/.drush/blah.aliases.drushrc.php:

    <?php
    $aliases['web1'] = array(
    'root' => '/var/www/drupal',
    'remote-user' => 'ubuntu',
    'remote-host' => 'web1.blah.com',
    );
    $aliases['web2'] = $aliases['web1'];
    $aliases['web2']['remote-host'] = 'web2.blah.com';
    ?>

Deploy stores it's settings in a deploy.drushrc.php file, which will go in the same locations as your drushrc.php and aliases.drushrc.php. Here is the minimal configuration needed to get started:

    <?php
    $options['application'] = 'blah';
    $options['deploy-repository'] = '[email protected]:blah/site_repo.git';
    $options['branch'] = "master";
    $options['keep-releases'] = 3;
    $options['deploy-via'] = 'RemoteCache';
    $options['docroot'] = '/var/www/drupal';
    ?>

To then deploy the latest from the master brance of [email protected]:blah/site_repo.git to the web servers web1.blah.com and web2.blah.com, you would do:

drush deploy @blah

REQUIREMENTS

• php 5.3
• non-windows OS

CONFIGURATION OPTIONS

Additional configuration options for your recipe can be included in your deploy.drushrc.php file as follows:

    <?php
    // Initialize, sync, and update submodules with 'git submodule' commands
    $options['git_enable_submodules'] = TRUE;
    // Run additional tasks after the 'current' symlink has been updated
    $options['after']['deploy-symlink'][] = 'my_custom_task';

    /**
     * The task needs to be defined with a @task "decorator" in the comment block preceding it
     * @task
     */
    function my_custom_task($d) {
      $d->run("ln -s /var/www/mysite.com/deploy/shared/settings.php %s/sites/default/settings.php", $d->latest_release());
      $d->run("ln -s /var/www/mysite.com/deploy/shared/files %s/sites/default/files", $d->latest_release());
    }
    ?>