Raw Notes: Advanced Drush

Posted by Jack on 03/09/2011 - 6:18pm

Drush for Teams

Workflow:
- // Write code
- git commit && git push
- //need most recent config?
- drush site-install -y welcom
- install drupal with profile with drush: drush site-install -y (which is the simplified command because of his drushrc.php) full command: drush si --yes $install_profile_name

Create installation profile files to quickly start from scratch with your standard setup
drushrc.php can include options you use often for drush commands (e.g. site-install)
place drushrc.php into root of your Drupal site and commit it
Pre-live - reinstall.sh (bash script that includes the bash commands your team needs to run before the reinstall, e.g. git pull)
drush sql-sync @prod @loca --sanitize: does a cache check (can be disabled, but checks for dump within 24 hours and doesn't do anotther one now if it finds one), generates table list, performs sql-dump on source database (@prod), rsync from the source to the target (@local), import now-local sql dump file, runs sanitize options that you've configured. Lots of optimizations for teams, move big databases quickly.
--sanitize: by default, overwrites account email and password with any heuristic you want; hook_drush_sql_sync_sanitize() for you to write your own routine for what happens during the --sanitize operation
@prod and @local are site aliases in aliaes.drushrc.php - collection of options that specify which ssh connection to a server to use to get the database. fancy features like site lists and inheritance. Example files comes with lots of documentation.
drush topic $command (e.g. drush topic docs-aliases) -- documentation for drush commands
policy.drush.inc (drush topic docs-policy): enforce the rules of the team, e.g. deny sql-sync TO production server, allows updatedb for only some users
Commands > drush script
- Write commands for your development team so they can easily figure out docs, options, args, examples, topics - structured way of telling people what you've written
- When you write a command it shows up when you run drush help
- Commands can have dependencies listed and enforced, validation and rollback
- drush make-me-a-sandwich

Drush Commands

Adapt to typical things that Linux shell users are accustomed to, packaged utilities for getting common tasks done
drush @d6 pml --type=module --status=enabled --no-core --pipe > d6en.txt, repeat for @d7 site (@d6 and @d7 are aliases)
diff -u d6en.txt and d7en.txt -- after running the above, this compares enabled modules on two different sites
cat 6em.txt d7en.txt | sort | uniq -d : show list of modules, sorted alphabetically, that are present on both sites.
--pipe is available on many drush commands
drush @$your_site_alias sql-cli - drop into sql cli for specified site quickly
drush @$your_site_alias sql-cli < whatever.sql - import specified file into specified site

Scripting

When you run PHP scripts via drush (drush scr $script.php) it runs them with the Drupal site fully bootstrapped, as if you're running commands through devel etc
alternative in Drush 4: native Drush scripts (see documentation for how to write them)

Drush Commands

When you're going for something more advanced/more flexible than drush scripts
Commands are like Drupal modules running in a different environment, they are written and work very similarly
Commands let you use/include help/docs, examples, options, arguments

git.drupal.org integration

Currently working in Drush 4.x and 5.x, will be in 4.e
Local git caching for pm with --cache option - http://www.randyfay.com/node/93
More to come!

Issue Queue Commands

drush iq-info $issuenumber
drush iq-apply-patch $issuecommentnumber (?)

Cache commands

drush cache-set blah "blah string"
drush cache-get schema --format=json

Node commands

drush entity-show $id - like print_r on an entity!
drush entity-delete
drush entity-edit $entity-type $id -- EDIT AN ENTITY FROM THE CLI
drush entity-show 1 --json | drush entity-create - (not sure of format exactly but think this is a way that you can copy an existing node via drush, EVEN BETWEEN SITES using aliases!
drush entity-show can be piped through mail to send a node to someone!

Parallelization

Currently, commands run on a group of site aliases execute in series.
This is slower than deploying all at the same time (i.e. parallelization)
Issue is up in drush queue and there is a patch: $1053072
Really really close to what Capistrano does; could soon have a drush deploy module that does it (without Ruby)!
Aegir problem has tackled a lot of these problems and they'll probably steal what they can