Installing Drush for working with Drupal 6-8 and Backdrop » History » Version 17
Jack Aponte, 07/08/2016 08:50 PM
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 | 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@. |
18 | |||
19 | <pre> |
||
20 | git clone https://github.com/drush-ops/drush.git -b 6.6.0 /usr/local/src/drush6 |
||
21 | cd /usr/local/src/drush6 |
||
22 | 1 | Jack Aponte | composer install |
23 | ln -s /usr/local/src/drush6/drush /usr/bin/drush6 |
||
24 | 16 | Jack Aponte | </pre> |
25 | |||
26 | 1 | Jack Aponte | To install Drush 7, run the following commands as root or using @sudo@. |
27 | |||
28 | <pre> |
||
29 | 13 | Jon Goldberg | git clone https://github.com/drush-ops/drush.git -b 7.3.0 /usr/local/src/drush7 |
30 | 1 | Jack Aponte | cd /usr/local/src/drush7 |
31 | composer install |
||
32 | ln -s /usr/local/src/drush7/drush /usr/bin/drush7 |
||
33 | </pre> |
||
34 | |||
35 | 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). |
36 | 1 | Jack Aponte | |
37 | Then install Drush 8, again running these commands as root or using @sudo@. |
||
38 | |||
39 | 6 | Jack Aponte | <pre> |
40 | git clone https://github.com/drush-ops/drush.git -b 8.0.5 /usr/local/src/drush8 |
||
41 | 1 | Jack Aponte | cd /usr/local/src/drush8 |
42 | 6 | Jack Aponte | composer install |
43 | 1 | Jack Aponte | ln -s /usr/local/src/drush8/drush /usr/bin/drush8 |
44 | </pre> |
||
45 | |||
46 | Replace "8.0.5" with the tag of the most recent stable 8.x release (see https://github.com/drush-ops/drush/releases) |
||
47 | |||
48 | You can now use the @drush6@, @drush7@ or @drush8@ commands to run each specific version of Drush. |
||
49 | |||
50 | *EXTRA TIP:* To update a Drush installation installed in this manner, run the following commands within the @/usr/local/src/<drush-version>@ directory: |
||
51 | |||
52 | <pre> |
||
53 | git pull origin master |
||
54 | git checkout tags/<new version> -b <new version> |
||
55 | composer install |
||
56 | </pre> |
||
57 | |||
58 | Replace @<new version>@ with the most recent stable release of the Drush version you're updating. |
||
59 | 17 | Jack Aponte | |
60 | |||
61 | *May First/People Link (MFPL) and other shared hosting environments* |
||
62 | |||
63 | Primarily drawn from "this MFPL ticket.":https://support.mayfirst.org/ticket/11691#comment:3 |
||
64 | |||
65 | First, install Composer following "these instructions":https://getcomposer.org/download/. |
||
66 | |||
67 | Then to install Drush: |
||
68 | |||
69 | <pre> |
||
70 | echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.bashrc |
||
71 | source ~/.bashrc |
||
72 | cd ~/web.warresisters.org/bin |
||
73 | php composer.phar global require drush/drush:7.3.0 |
||
74 | which drush |
||
75 | </pre> |
||
76 | 1 | Jack Aponte | |
77 | 5 | Jack Aponte | h2. Install Backdrop Drush commands |
78 | 4 | Jack Aponte | |
79 | 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. |
||
80 | |||
81 | Assuming that Drush 8 is installed in @/usr/local/src/drush8@, as specified above: |
||
82 | |||
83 | <pre> |
||
84 | git clone https://github.com/backdrop-contrib/drush.git /usr/local/src/drush8/commands/backdrop |
||
85 | </pre> |
||
86 | 1 | Jack Aponte | |
87 | h2. Create script to automatically switch Drush versions based on git configuration setting |
||
88 | |||
89 | 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. |
||
90 | |||
91 | The script, which lives at @/usr/bin/drush@ and is therefore called whenever someone runs the @drush@ command: |
||
92 | |||
93 | <pre> |
||
94 | #!/bin/bash |
||
95 | version=$(git config --get drush.version) |
||
96 | if [ "$version" = '8' ]; |
||
97 | then |
||
98 | drush8 "$@" |
||
99 | 6 | Jack Aponte | elif [ "$version" = '6' ]; |
100 | then |
||
101 | drush6 "$@" |
||
102 | 1 | Jack Aponte | else |
103 | drush7 "$@" |
||
104 | fi |
||
105 | 2 | Jack Aponte | </pre> |
106 | 1 | Jack Aponte | |
107 | h2. Set drush.version git variable on a per-project basis |
||
108 | |||
109 | 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: |
110 | 1 | Jack Aponte | |
111 | <pre> |
||
112 | $ drush --version |
||
113 | Drush Version : 7.2.0 |
||
114 | $ git config drush.version 8 |
||
115 | $ drush --version |
||
116 | Drush Version : 8.0.5 |
||
117 | </pre> |
||
118 | |||
119 | h2. Update Drush remote site aliases to use correct Drush scripts |
||
120 | |||
121 | 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>. |
||
122 | 7 | Jack Aponte | |
123 | 1 | Jack Aponte | An example @aliases.drushrc.php@ file with <code>%drush-script</code> specified: |
124 | |||
125 | <pre> |
||
126 | $aliases['drupal8'] = array( |
||
127 | 'remote-host' => 'fake-dev-server.palantetech.coop', |
||
128 | 'remote-user' => 'jack', |
||
129 | 'root' => '/var/www/dev/drupal8', |
||
130 | 'uri' => 'drupal8.palantetech.coop', |
||
131 | 'path-aliases' => array( |
||
132 | '%drush-script' => '/usr/bin/drush8', |
||
133 | ) |
||
134 | ); |
||
135 | 8 | Jack Aponte | $aliases['drupal7'] = array( |
136 | 1 | Jack Aponte | 'remote-host' => 'fake-dev-server.palantetech.coop', |
137 | 'remote-user' => 'jack', |
||
138 | 8 | Jack Aponte | 'root' => '/var/www/dev/drupal7', |
139 | 'uri' => 'drupal7.palantetech.coop', |
||
140 | 1 | Jack Aponte | 'path-aliases' => array( |
141 | 8 | Jack Aponte | '%drush-script' => '/usr/bin/drush7', |
142 | 1 | Jack Aponte | ) |
143 | ); |
||
144 | </pre> |
||
145 | 10 | Jack Aponte | |
146 | h2. Additional resources |
||
147 | |||
148 | * https://www.triquanta.nl/blog/automatically-switch-drush-versions-project |
||
149 | * https://www.lullabot.com/articles/switching-drush-versions |