Ansible Role: Drush

Installs Drush, a command line shell and scripting interface for Drupal, on any Linux or UNIX system.

Requirements

None.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

drush_install_path: /usr/local/share/drush

The location of the entire drush installation (includes all the supporting files, as well as the drush executable file.

drush_path: /usr/local/bin/drush

The path where drush will be installed and available to your system. Should be in your user's $PATH so you can run commands simply with drush instead of the full path.

drush_git_path: /usr/bin/git    

The path where this playbook will look to make sure git is installed.

drush_git_path: /usr/local/bin/composer    

The path where this playbook will look to make sure composer is installed.

drush_version: "master"

The version of Drush to install (examples: "master" for the bleeding edge, "7.x", "6.x", "6.2.0"). This should be a string as it refers to a git branch, tag, or commit hash.

drush_keep_updated: no
drush_force_update: no

Whether to keep Drush up-to-date with the latest revision of the branch specified by drush_version, and whether to force the update (e.g. overwrite local modifications to the drush repository).

drush_composer_cli_options: "--prefer-source --no-interaction"

These options are the safest for avoiding GitHub API rate limits when installing Drush, and can be very helpful when working on dependencies/installation, but builds can be sped up substantially by changing the first option to --prefer-dist.

Dependencies

Git and Composer must be installed. A check is done to make sure that they are (see drush_composer_path and drush_git_path above). I recommend using geeringlingguy.git and geerlingguy.php to install git and php.

Example Playbook

- hosts: servers
  roles:
    - { role: geerlingguy.drush }

After the playbook runs, the drush command will be accessible from normal system accounts.

License

MIT / BSD

Author Information

This role was created in 2014 by Jeff Geerling, author of Ansible for DevOps.