Installing Drush for working with Drupal 6-8 and Backdrop » History » Version 26
Jack Aponte, 03/17/2017 08:08 PM
updated Drush 8 version
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 | 24 | Jack Aponte | git clone https://github.com/drush-ops/drush.git -b 7.4.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 | 24 | Jack Aponte | Replace "7.4.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 | 26 | Jack Aponte | git clone https://github.com/drush-ops/drush.git -b 8.1.10 /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 | 26 | Jack Aponte | Replace "8.1.10" with the tag of the most recent stable 8.x release (see https://github.com/drush-ops/drush/releases) |
47 | 1 | Jack Aponte | |
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 | 18 | Jack Aponte | h2. Install Drush on May First/People Link (MFPL) and other shared hosting environments |
61 | 17 | Jack Aponte | |
62 | 22 | Jack Aponte | Primarily drawn from "this MFPL ticket;":https://support.mayfirst.org/ticket/11691#comment:3 thanks Ivan! |
63 | 17 | Jack Aponte | |
64 | First, install Composer following "these instructions":https://getcomposer.org/download/. |
||
65 | |||
66 | Then to install Drush: |
||
67 | |||
68 | <pre> |
||
69 | echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.bashrc |
||
70 | source ~/.bashrc |
||
71 | 23 | Jack Aponte | cd ~/<organization.org>/bin |
72 | 25 | Jack Aponte | php composer.phar global require drush/drush:7.4.0 |
73 | 1 | Jack Aponte | which drush |
74 | </pre> |
||
75 | 23 | Jack Aponte | |
76 | Note that sometimes @cgi-bin@ is present on MFPL sites instead of @bin@. |
||
77 | 19 | Jack Aponte | |
78 | 20 | Jack Aponte | If using Drush aliases, you may need to specify the new Drush installation in the shared @aliases.drushrc.php@ file or a local aliases file. Here's an example: |
79 | 19 | Jack Aponte | |
80 | <pre> |
||
81 | 20 | Jack Aponte | $aliases['organization'] = array( |
82 | 'remote-host' => 'organization.org', |
||
83 | 'remote-user' => 'organization', |
||
84 | 'root' => '/home/members/organization/sites/organization.org/web', |
||
85 | 'uri' => 'organization.org', |
||
86 | 19 | Jack Aponte | 'path-aliases' => array( |
87 | 21 | Jack Aponte | '%drush-script' => '/home/members/organization/sites/organization.org/users/organization/.composer/vendor/bin/drush', |
88 | 19 | Jack Aponte | '%dump-dir' => '~/drush-backups', |
89 | 20 | Jack Aponte | '%files' => '/home/members/organization/sites/organization.org/web/sites/default/files',), |
90 | 19 | Jack Aponte | ); |
91 | 17 | Jack Aponte | </pre> |
92 | 1 | Jack Aponte | |
93 | 5 | Jack Aponte | h2. Install Backdrop Drush commands |
94 | 4 | Jack Aponte | |
95 | 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. |
||
96 | |||
97 | Assuming that Drush 8 is installed in @/usr/local/src/drush8@, as specified above: |
||
98 | |||
99 | <pre> |
||
100 | git clone https://github.com/backdrop-contrib/drush.git /usr/local/src/drush8/commands/backdrop |
||
101 | </pre> |
||
102 | 1 | Jack Aponte | |
103 | h2. Create script to automatically switch Drush versions based on git configuration setting |
||
104 | |||
105 | 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. |
||
106 | |||
107 | The script, which lives at @/usr/bin/drush@ and is therefore called whenever someone runs the @drush@ command: |
||
108 | |||
109 | <pre> |
||
110 | #!/bin/bash |
||
111 | version=$(git config --get drush.version) |
||
112 | if [ "$version" = '8' ]; |
||
113 | then |
||
114 | drush8 "$@" |
||
115 | 6 | Jack Aponte | elif [ "$version" = '6' ]; |
116 | then |
||
117 | drush6 "$@" |
||
118 | 1 | Jack Aponte | else |
119 | drush7 "$@" |
||
120 | fi |
||
121 | 2 | Jack Aponte | </pre> |
122 | 1 | Jack Aponte | |
123 | h2. Set drush.version git variable on a per-project basis |
||
124 | |||
125 | 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: |
126 | 1 | Jack Aponte | |
127 | <pre> |
||
128 | $ drush --version |
||
129 | Drush Version : 7.2.0 |
||
130 | $ git config drush.version 8 |
||
131 | $ drush --version |
||
132 | Drush Version : 8.0.5 |
||
133 | </pre> |
||
134 | |||
135 | h2. Update Drush remote site aliases to use correct Drush scripts |
||
136 | |||
137 | 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>. |
||
138 | 7 | Jack Aponte | |
139 | 1 | Jack Aponte | An example @aliases.drushrc.php@ file with <code>%drush-script</code> specified: |
140 | |||
141 | <pre> |
||
142 | $aliases['drupal8'] = array( |
||
143 | 'remote-host' => 'fake-dev-server.palantetech.coop', |
||
144 | 'remote-user' => 'jack', |
||
145 | 'root' => '/var/www/dev/drupal8', |
||
146 | 'uri' => 'drupal8.palantetech.coop', |
||
147 | 'path-aliases' => array( |
||
148 | '%drush-script' => '/usr/bin/drush8', |
||
149 | ) |
||
150 | ); |
||
151 | 8 | Jack Aponte | $aliases['drupal7'] = array( |
152 | 1 | Jack Aponte | 'remote-host' => 'fake-dev-server.palantetech.coop', |
153 | 'remote-user' => 'jack', |
||
154 | 8 | Jack Aponte | 'root' => '/var/www/dev/drupal7', |
155 | 'uri' => 'drupal7.palantetech.coop', |
||
156 | 1 | Jack Aponte | 'path-aliases' => array( |
157 | 8 | Jack Aponte | '%drush-script' => '/usr/bin/drush7', |
158 | 1 | Jack Aponte | ) |
159 | ); |
||
160 | </pre> |
||
161 | 10 | Jack Aponte | |
162 | h2. Additional resources |
||
163 | |||
164 | * https://www.triquanta.nl/blog/automatically-switch-drush-versions-project |
||
165 | * https://www.lullabot.com/articles/switching-drush-versions |