Installing Drush for working with Drupal 6-8 and Backdrop » History » Version 30
Jack Aponte, 08/12/2018 10:40 PM
fixed section on updating drush
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 | 28 | Jack Aponte | TODO: Update the instructions below to indicate that running @composer install@ as root is a "security risk":https://getcomposer.org/doc/faqs/how-to-install-untrusted-packages-safely.md, give alternative approach. |
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 | 1 | Jack Aponte | composer install |
25 | ln -s /usr/local/src/drush6/drush /usr/bin/drush6 |
||
26 | 16 | Jack Aponte | </pre> |
27 | |||
28 | 1 | Jack Aponte | To install Drush 7, run the following commands as root or using @sudo@. |
29 | |||
30 | <pre> |
||
31 | 24 | Jack Aponte | git clone https://github.com/drush-ops/drush.git -b 7.4.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 | 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). |
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 | 29 | Jack Aponte | git clone https://github.com/drush-ops/drush.git -b 8.1.15 /usr/local/src/drush8 |
43 | 1 | Jack Aponte | cd /usr/local/src/drush8 |
44 | 6 | Jack Aponte | composer install |
45 | 1 | Jack Aponte | ln -s /usr/local/src/drush8/drush /usr/bin/drush8 |
46 | </pre> |
||
47 | |||
48 | 29 | Jack Aponte | Replace "8.1.15" (last updated in this documentation on 11/9/17) with the tag of the most recent stable 8.x release (see https://github.com/drush-ops/drush/releases) |
49 | 1 | Jack Aponte | |
50 | You can now use the @drush6@, @drush7@ or @drush8@ commands to run each specific version of Drush. |
||
51 | |||
52 | 30 | Jack Aponte | h3. Updating Drush when installed this way |
53 | 1 | Jack Aponte | |
54 | 30 | Jack Aponte | To update a Drush installation installed in this manner, run the following commands within the @/usr/local/src/<drush-version>@ directory: |
55 | |||
56 | 1 | Jack Aponte | <pre> |
57 | 30 | Jack Aponte | git fetch |
58 | 1 | Jack Aponte | git pull origin master |
59 | git checkout tags/<new version> -b <new version> |
||
60 | composer install |
||
61 | </pre> |
||
62 | |||
63 | Replace @<new version>@ with the most recent stable release of the Drush version you're updating. |
||
64 | 17 | Jack Aponte | |
65 | 18 | Jack Aponte | h2. Install Drush on May First/People Link (MFPL) and other shared hosting environments |
66 | 17 | Jack Aponte | |
67 | 22 | Jack Aponte | Primarily drawn from "this MFPL ticket;":https://support.mayfirst.org/ticket/11691#comment:3 thanks Ivan! |
68 | 17 | Jack Aponte | |
69 | First, install Composer following "these instructions":https://getcomposer.org/download/. |
||
70 | |||
71 | Then to install Drush: |
||
72 | |||
73 | <pre> |
||
74 | echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.bashrc |
||
75 | source ~/.bashrc |
||
76 | 23 | Jack Aponte | cd ~/<organization.org>/bin |
77 | 25 | Jack Aponte | php composer.phar global require drush/drush:7.4.0 |
78 | 1 | Jack Aponte | which drush |
79 | </pre> |
||
80 | 23 | Jack Aponte | |
81 | Note that sometimes @cgi-bin@ is present on MFPL sites instead of @bin@. |
||
82 | 19 | Jack Aponte | |
83 | 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: |
84 | 19 | Jack Aponte | |
85 | <pre> |
||
86 | 20 | Jack Aponte | $aliases['organization'] = array( |
87 | 'remote-host' => 'organization.org', |
||
88 | 'remote-user' => 'organization', |
||
89 | 'root' => '/home/members/organization/sites/organization.org/web', |
||
90 | 'uri' => 'organization.org', |
||
91 | 19 | Jack Aponte | 'path-aliases' => array( |
92 | 21 | Jack Aponte | '%drush-script' => '/home/members/organization/sites/organization.org/users/organization/.composer/vendor/bin/drush', |
93 | 19 | Jack Aponte | '%dump-dir' => '~/drush-backups', |
94 | 20 | Jack Aponte | '%files' => '/home/members/organization/sites/organization.org/web/sites/default/files',), |
95 | 19 | Jack Aponte | ); |
96 | 17 | Jack Aponte | </pre> |
97 | 1 | Jack Aponte | |
98 | 5 | Jack Aponte | h2. Install Backdrop Drush commands |
99 | 4 | Jack Aponte | |
100 | 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. |
||
101 | |||
102 | Assuming that Drush 8 is installed in @/usr/local/src/drush8@, as specified above: |
||
103 | |||
104 | <pre> |
||
105 | git clone https://github.com/backdrop-contrib/drush.git /usr/local/src/drush8/commands/backdrop |
||
106 | </pre> |
||
107 | 1 | Jack Aponte | |
108 | h2. Create script to automatically switch Drush versions based on git configuration setting |
||
109 | |||
110 | 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. |
||
111 | |||
112 | The script, which lives at @/usr/bin/drush@ and is therefore called whenever someone runs the @drush@ command: |
||
113 | |||
114 | <pre> |
||
115 | #!/bin/bash |
||
116 | version=$(git config --get drush.version) |
||
117 | if [ "$version" = '8' ]; |
||
118 | then |
||
119 | drush8 "$@" |
||
120 | 6 | Jack Aponte | elif [ "$version" = '6' ]; |
121 | then |
||
122 | drush6 "$@" |
||
123 | 1 | Jack Aponte | else |
124 | drush7 "$@" |
||
125 | fi |
||
126 | 2 | Jack Aponte | </pre> |
127 | 1 | Jack Aponte | |
128 | h2. Set drush.version git variable on a per-project basis |
||
129 | |||
130 | 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: |
131 | 1 | Jack Aponte | |
132 | <pre> |
||
133 | $ drush --version |
||
134 | Drush Version : 7.2.0 |
||
135 | $ git config drush.version 8 |
||
136 | $ drush --version |
||
137 | Drush Version : 8.0.5 |
||
138 | </pre> |
||
139 | |||
140 | h2. Update Drush remote site aliases to use correct Drush scripts |
||
141 | |||
142 | 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>. |
||
143 | 7 | Jack Aponte | |
144 | 1 | Jack Aponte | An example @aliases.drushrc.php@ file with <code>%drush-script</code> specified: |
145 | |||
146 | <pre> |
||
147 | $aliases['drupal8'] = array( |
||
148 | 'remote-host' => 'fake-dev-server.palantetech.coop', |
||
149 | 'remote-user' => 'jack', |
||
150 | 'root' => '/var/www/dev/drupal8', |
||
151 | 'uri' => 'drupal8.palantetech.coop', |
||
152 | 'path-aliases' => array( |
||
153 | '%drush-script' => '/usr/bin/drush8', |
||
154 | ) |
||
155 | ); |
||
156 | 8 | Jack Aponte | $aliases['drupal7'] = array( |
157 | 1 | Jack Aponte | 'remote-host' => 'fake-dev-server.palantetech.coop', |
158 | 'remote-user' => 'jack', |
||
159 | 8 | Jack Aponte | 'root' => '/var/www/dev/drupal7', |
160 | 'uri' => 'drupal7.palantetech.coop', |
||
161 | 1 | Jack Aponte | 'path-aliases' => array( |
162 | 8 | Jack Aponte | '%drush-script' => '/usr/bin/drush7', |
163 | 1 | Jack Aponte | ) |
164 | ); |
||
165 | </pre> |
||
166 | 10 | Jack Aponte | |
167 | h2. Additional resources |
||
168 | |||
169 | * https://www.triquanta.nl/blog/automatically-switch-drush-versions-project |
||
170 | * https://www.lullabot.com/articles/switching-drush-versions |