Installing Drush for working with Drupal 6-8 and Backdrop » History » Version 15
Jack Aponte, 07/08/2016 08:38 PM
TODO: add instructions for doing this on MFPL (and other shared hosting environments)
1 | 14 | Jack Aponte | {{lastupdated_at}} by {{lastupdated_by}} |
---|---|---|---|
2 | |||
3 | 1 | Jack Aponte | h1. Installing Drush for working with Drupal 6-8 and Backdrop |
4 | |||
5 | 9 | Jack Aponte | Palante has a few reasons to run different versions of Drush: |
6 | |||
7 | * We're currently supporting or building Drupal 6, 7, 8 _and_ Backdrop sites. |
||
8 | * We've fallen victim to the "weird gotcha where Drush destroys your git repo and other non-Drupal files":https://github.com/drush-ops/drush/issues/1581 that seems to happen more often with Drush 8 than other versions. |
||
9 | * Some of our clients' servers don't support anything newer than Drush 6; if we run remote commands against those servers, like @drush sql-sync@, we need to use Drush 6 locally, too. |
||
10 | 1 | Jack Aponte | |
11 | 6 | Jack Aponte | Below is a solution that allows us to use Drush 6, 7 and 8 in the same environment. |
12 | 1 | Jack Aponte | |
13 | 6 | Jack Aponte | h2. Install Drush 6, 7 and 8 for all users |
14 | 1 | Jack Aponte | |
15 | 11 | Jack Aponte | I've followed the "To install for all users on the server" instructions under "Composer - One Drush for all Projects" in the "Drush 7 installation documentation":http://docs.drush.org/en/7.x/install/, adapted for different versions of Drush. |
16 | 1 | Jack Aponte | |
17 | 15 | Jack Aponte | *TODO: add instructions for doing this on MFPL (and other shared hosting environments)* |
18 | |||
19 | 8 | Jack Aponte | Some of our clients' servers aren't capable of running anything newer than Drush 6. If you need to run commands like @drush sql-sync@ against those servers from your local or dev environment, you'll need Drush 6 installed. Run the following commands as root or using @sudo@. |
20 | |||
21 | <pre> |
||
22 | git clone https://github.com/drush-ops/drush.git -b 6.6.0 /usr/local/src/drush6 |
||
23 | cd /usr/local/src/drush6 |
||
24 | composer install |
||
25 | ln -s /usr/local/src/drush6/drush /usr/bin/drush6 |
||
26 | </pre> |
||
27 | |||
28 | 1 | Jack Aponte | To install Drush 7, run the following commands as root or using @sudo@. |
29 | |||
30 | <pre> |
||
31 | 13 | Jon Goldberg | git clone https://github.com/drush-ops/drush.git -b 7.3.0 /usr/local/src/drush7 |
32 | 1 | Jack Aponte | cd /usr/local/src/drush7 |
33 | composer install |
||
34 | ln -s /usr/local/src/drush7/drush /usr/bin/drush7 |
||
35 | </pre> |
||
36 | |||
37 | 13 | Jon Goldberg | Replace "7.3.0" with the tag of the most recent stable 7.x release (see https://github.com/drush-ops/drush/releases). |
38 | 1 | Jack Aponte | |
39 | Then install Drush 8, again running these commands as root or using @sudo@. |
||
40 | |||
41 | 6 | Jack Aponte | <pre> |
42 | git clone https://github.com/drush-ops/drush.git -b 8.0.5 /usr/local/src/drush8 |
||
43 | 1 | Jack Aponte | cd /usr/local/src/drush8 |
44 | 6 | Jack Aponte | composer install |
45 | ln -s /usr/local/src/drush8/drush /usr/bin/drush8 |
||
46 | </pre> |
||
47 | 1 | Jack Aponte | |
48 | Replace "8.0.5" with the tag of the most recent stable 8.x release (see https://github.com/drush-ops/drush/releases) |
||
49 | |||
50 | You can now use the @drush6@, @drush7@ or @drush8@ commands to run each specific version of Drush. |
||
51 | |||
52 | 12 | Jack Aponte | *EXTRA TIP:* To update a Drush installation installed in this manner, run the following commands within the @/usr/local/src/<drush-version>@ directory: |
53 | 1 | Jack Aponte | |
54 | <pre> |
||
55 | git pull origin master |
||
56 | 8 | Jack Aponte | git checkout tags/<new version> -b <new version> |
57 | 1 | Jack Aponte | composer install |
58 | </pre> |
||
59 | |||
60 | 8 | Jack Aponte | Replace @<new version>@ with the most recent stable release of the Drush version you're updating. |
61 | 1 | Jack Aponte | |
62 | 5 | Jack Aponte | h2. Install Backdrop Drush commands |
63 | 4 | Jack Aponte | |
64 | In order for Drush to work with Backdrop, you must install the "Drush Backdrop commands":https://github.com/backdrop-contrib/drush within the Drush 8 installation itself. |
||
65 | |||
66 | Assuming that Drush 8 is installed in @/usr/local/src/drush8@, as specified above: |
||
67 | |||
68 | <pre> |
||
69 | git clone https://github.com/backdrop-contrib/drush.git /usr/local/src/drush8/commands/backdrop |
||
70 | </pre> |
||
71 | 1 | Jack Aponte | |
72 | h2. Create script to automatically switch Drush versions based on git configuration setting |
||
73 | |||
74 | As per "this excellent guide from Marc van Gend of Triquanta":https://www.triquanta.nl/blog/automatically-switch-drush-versions-project, I've set up a script to let us switch between versions of Drush on a project-by-project basis using git configuration settings. |
||
75 | |||
76 | The script, which lives at @/usr/bin/drush@ and is therefore called whenever someone runs the @drush@ command: |
||
77 | |||
78 | <pre> |
||
79 | #!/bin/bash |
||
80 | version=$(git config --get drush.version) |
||
81 | if [ "$version" = '8' ]; |
||
82 | then |
||
83 | drush8 "$@" |
||
84 | 6 | Jack Aponte | elif [ "$version" = '6' ]; |
85 | then |
||
86 | drush6 "$@" |
||
87 | 1 | Jack Aponte | else |
88 | drush7 "$@" |
||
89 | fi |
||
90 | 2 | Jack Aponte | </pre> |
91 | 1 | Jack Aponte | |
92 | h2. Set drush.version git variable on a per-project basis |
||
93 | |||
94 | 8 | Jack Aponte | In this configuration, Drush 7 is the default version of Drush. For the script above to automatically switch to a non-default version of Drush for a given project, set the @drush.version@ value in the git repo for the project by running @git config drush.version <version>@. For example: |
95 | 1 | Jack Aponte | |
96 | <pre> |
||
97 | $ drush --version |
||
98 | Drush Version : 7.2.0 |
||
99 | $ git config drush.version 8 |
||
100 | $ drush --version |
||
101 | Drush Version : 8.0.5 |
||
102 | </pre> |
||
103 | |||
104 | h2. Update Drush remote site aliases to use correct Drush scripts |
||
105 | |||
106 | If you've got Drush site aliases set up for remote sites on servers where multiple versions of Drush are available, update your @aliases.drushrc.php@ file to include the specific drush script that should be used on the remote site. See the "example.aliases.drushrc.php":https://github.com/drush-ops/drush/blob/master/examples/example.aliases.drushrc.php file if you need help creating your @aliases.drushrc.php@ file or learning about <code>%drush-script</code>. |
||
107 | 7 | Jack Aponte | |
108 | 1 | Jack Aponte | An example @aliases.drushrc.php@ file with <code>%drush-script</code> specified: |
109 | |||
110 | <pre> |
||
111 | $aliases['drupal8'] = array( |
||
112 | 'remote-host' => 'fake-dev-server.palantetech.coop', |
||
113 | 'remote-user' => 'jack', |
||
114 | 'root' => '/var/www/dev/drupal8', |
||
115 | 'uri' => 'drupal8.palantetech.coop', |
||
116 | 'path-aliases' => array( |
||
117 | '%drush-script' => '/usr/bin/drush8', |
||
118 | ) |
||
119 | ); |
||
120 | 8 | Jack Aponte | $aliases['drupal7'] = array( |
121 | 1 | Jack Aponte | 'remote-host' => 'fake-dev-server.palantetech.coop', |
122 | 'remote-user' => 'jack', |
||
123 | 8 | Jack Aponte | 'root' => '/var/www/dev/drupal7', |
124 | 'uri' => 'drupal7.palantetech.coop', |
||
125 | 1 | Jack Aponte | 'path-aliases' => array( |
126 | 8 | Jack Aponte | '%drush-script' => '/usr/bin/drush7', |
127 | 1 | Jack Aponte | ) |
128 | ); |
||
129 | </pre> |
||
130 | 10 | Jack Aponte | |
131 | h2. Additional resources |
||
132 | |||
133 | * https://www.triquanta.nl/blog/automatically-switch-drush-versions-project |
||
134 | * https://www.lullabot.com/articles/switching-drush-versions |