How to Install, Use, and Customize Drush

Drush: The essential Drupal tool

Tuesday, November 29, 2011

@JacobSingh

Trainer Engineer Speaker

About me

http://jacobsingh.name




@JacobSingh

Lover Fighter Whiskers

About movember

HTTP://TINYURL.COM/JACOBMO


http://us.movember.com/mospace/726874

http://us.movember.com/mospace/726874

What do programmers hate more than

anything?


Work that is


Tedious


& Repetitive


Introducing


Drush!


Drupal + shell


What the shell?


The Shell

• a.k.a. Terminal, Command Line, CLI

• Type commands to interact with your computer

• Windows = DOS and PowerShell

• Linux / OSX = bash, sh, rsh


Exercise: Open the shell


Windows

• Click on Start

• Type “cmd” into the program search

• Hit enter to select the command prompt


OSX

• Go to Applications -‐> Utilities

• Click on terminal


Exercise: Installing Drush


pear channel-discover pear.drush.orgpear install drush/drush

* Windows is a little different. See http://drush.ws


http://drush.ws

http://drush.ws

Why Drush?

• Speed

• Automation


Drush can do a lot of things


command (cmd)description.


Let’s try a few


cache-clear (cc) Clear a specific cache, or all

drupal caches.


Exercise: Download Drupal


pm-download (dl) Download projects from drupal.org or

other sources.


Downloading Drupal

dl drupalDrush


Exercise: Install Drupal


site-install (si) Install Drupal along with modules/

themes/configuration using the specified install profile.


drush site-installCould not find a Drupal settings.php file

at ./sites/default/settings.php. Could not determine database connection

parameters. . Pass --db-url option


Pass --db-url option


Pass --db-url option.


Drush command Structure

Command Options Arguments


site-install --db-url=mysql://....

cache-clear theme

Examples

Run the install command, using the db-url “mysql://...” (no arguments)

Clear the theme cache (no options)

dl drupal

Download Drupal to /tmp/drupal

--destination=/tmp/drupal


Most important option!!!!


--help


--helpsite-installLists all of the options and arguments for the site-

install command. Also provides examples.


Exercise: Adding modules


Download views

dl viewsDrush


Project views (7.x-3.0-rc3) downloaded to www/sites/all/modules/

views. Project views contains 2 modules:

views, views_ui.


Exercise: Enabling modules


pm-enable (en) Enable one or more extensions

(modules or themes).


Enable views

en views views_uiDrush


Any questions before we continue?


Updating modules

dl webform-7.x-3.11Drush

upc webformDrush

updatedbDrush

en webformDrush

--no-core


http://drupal.org/node/1161906

http://drupal.org/node/1161906

pm-updatecode (upc) Update Drupal core and contrib projects to latest recommended

releases


updatedb (updb)Apply any database updates required

(as with running update.php).


But there’s more!


user-login (uli)Display a one time login link for

the given user account (defaults to uid 1).

Forget the password?


$ drush ulihttp://localhost/?q=user/reset/

1/1322445074/5wbzEG1jyjNZpbVRIasOjYaXvsY3cuu9TK0ZaRsrk2Q


http://localhost/?q=user/reset/1/1322445074/5wbzEG1jyjNZpbVRIasOjYaXvsY3cuu9TK0ZaRsrk2Q






sql-dumpExports the Drupal DB as SQL using

mysqldump or equivalent.

Moving the database?


sql-dump > /backups/site-backup.sql

ssh user@host ‘drush sql-dump | gzip -’ |

gunzip - | mysql localdb


variable-set (vset) Set a variable.


drush vset maintenance_mode 1

Take the site offline


watchdog-show (ws)Show watchdog messages.


Aliases


Aliases

• Used to run drush commands from anywhere.

• Syntax: drush @myalias cc all

• myalias could be local, or remote.

• Stored in ~/.drush


$aliases[jacobsingh.local] = array( 'uri' => jacobsingh.local, 'root' => '/Users/jacob/work/engineering/gardens/trunk/docroot',);

$aliases['training.test'] = array( 'root' => '/var/www/html/trainingstg/docroot', 'remote-host' => 'staging-9.network.hosting.acquia.com', 'remote-user' => 'training',);


drush @jacobsingh.local cc all

Clears the cache on my local site


drush @training.test cc all

SSH’s into the training site, clears the cache.


But there’s more!


Deployment

• drush rsync

• drush sql-‐sync

• drush site-‐upgrade

• archive-‐dump | archive-‐restore

• test-‐run


Maintenance

• search-‐reindex

• image-‐flush

• cache-‐clear

• watchdog-‐show


Configuration management

• features-‐update

• features-‐diff

• features-‐revert


User management

• user-‐add-‐role

• user-‐create

• user-‐password

• user-‐block


Extendable

• 92 addons available on Drupal.org

• Writing extensions is pretty easy!

• Examples: ApacheSolr, Backup and Migrate, Coder, Simpletest, Views, Devel Generate.


drush.ws


How to Install, Use, and Customize Drush

Technology

Transcript of How to Install, Use, and Customize Drush