Drush » Historique » Version 18
Florent Torregrosa, 28/07/2013 10:43
toc à droite
1 | 1 | Julien Enselme | |
---|---|---|---|
2 | 18 | Florent Torregrosa | |
3 | 1 | Julien Enselme | {{important(drush n'est pas installé sur le compte assos mais seulement sur le sas)}} |
4 | 12 | Julien Enselme | {{important(Si vous *modifiez les fichiers de configuration de drush*, pensez à vider les caches avec _drush cache-clear drush_)}} |
5 | 2 | Julien Enselme | |
6 | 1 | Julien Enselme | h1. C'est quoi ? |
7 | 18 | Florent Torregrosa | |
8 | 18 | Florent Torregrosa | {{>toc}} |
9 | 1 | Julien Enselme | |
10 | 1 | Julien Enselme | Drush signifie _drupal shell_. C'est un utilitaire disponible sur nos installations afin d'administrer nos sites en ligne de commande. |
11 | 1 | Julien Enselme | |
12 | 1 | Julien Enselme | Pour avoir la liste des commandes les plus simples, taper drush dans un terminal, ou consulter cette http://drupal.org/node/477684. |
13 | 1 | Julien Enselme | |
14 | 1 | Julien Enselme | Pour effectuer une action, il faut au préalable se placer dans le dossier du site concerné, puis taper la commande drush. |
15 | 1 | Julien Enselme | |
16 | 9 | Julien Enselme | h1. Quelques exemples simples |
17 | 1 | Julien Enselme | |
18 | 1 | Julien Enselme | * activer le module ou le thème nommé projet : <code>drush en projet</code> |
19 | 1 | Julien Enselme | * désactiver le module ou le thème nommé projet <code>drush dis projet </code> |
20 | 1 | Julien Enselme | * lister les modules et les thèmes, leurs statuts (activé, désactivé, pas installé), et leurs versions <code>drush pml </code> |
21 | 1 | Julien Enselme | * désinstaller le module ou le thème nommé projet <code>drush pm-uninstall projet </code> |
22 | 1 | Julien Enselme | |
23 | 1 | Julien Enselme | **Rappel :** désinstaller un projet = le désactiver + supprimer les tables de ce projet dans la base de données |
24 | 1 | Julien Enselme | |
25 | 1 | Julien Enselme | * récupérer la valeur actuelle de la variable nommée ma_variable <code>drush vget ma_variable </code> |
26 | 1 | Julien Enselme | * modifier la valeur de _ma_variable_ en _nvelle_valeur_ <code>drush vset ma_variable nvelle_valeur </code> |
27 | 1 | Julien Enselme | |
28 | 1 | Julien Enselme | NB : une variable est un champ de la table monsite_variables (dans la base de données). |
29 | 1 | Julien Enselme | On peut citer par exemple _theme_default_ le thème par défaut du site ou _admin_theme_ le thème de l'administration. |
30 | 1 | Julien Enselme | |
31 | 1 | Julien Enselme | * vider tous les caches <code>drush cc all</code> |
32 | 1 | Julien Enselme | |
33 | 9 | Julien Enselme | h1. Gérer les utilisateurs |
34 | 1 | Julien Enselme | |
35 | 9 | Julien Enselme | h2. Savoir qui administre un site |
36 | 1 | Julien Enselme | |
37 | 1 | Julien Enselme | **À partir de drupal 7** |
38 | 1 | Julien Enselme | Cette commande permet de chercher dans la base de données les utilisateurs qui ont le _rid_ numéro 3 (qui correspond au rôle d'administrateur (toujours) dans D7 à moins d'aller exprès dans la bdd le changer !) |
39 | 1 | Julien Enselme | <pre> |
40 | 1 | Julien Enselme | <code> |
41 | 15 | Julien Enselme | drush sqlq "SELECT name, mail FROM users WHERE uid IN (SELECT uid FROM users_roles WHERE rid=3);" |
42 | 15 | Julien Enselme | </code> |
43 | 15 | Julien Enselme | </pre> |
44 | 15 | Julien Enselme | |
45 | 15 | Julien Enselme | Si le site à un préfix (en cours de disparition) : |
46 | 15 | Julien Enselme | <pre> |
47 | 15 | Julien Enselme | <code> |
48 | 1 | Julien Enselme | drush sqlq "SELECT name, mail FROM nomdusite_users WHERE uid IN (SELECT uid FROM nomdusite_users_roles WHERE rid=3);" |
49 | 1 | Julien Enselme | </code> |
50 | 1 | Julien Enselme | </pre> |
51 | 1 | Julien Enselme | |
52 | 9 | Julien Enselme | h2. Obtenir des informations sur un utilisateur |
53 | 1 | Julien Enselme | |
54 | 1 | Julien Enselme | Retourne, pour un login donné, l'uid, l'adresse mail, les rôles et le statut. |
55 | 1 | Julien Enselme | <pre> |
56 | 1 | Julien Enselme | <code>drush uinf mon_utilisateur</code> |
57 | 1 | Julien Enselme | </pre> |
58 | 1 | Julien Enselme | |
59 | 9 | Julien Enselme | h2. Changer le mot de passe d'un utilisateur |
60 | 1 | Julien Enselme | |
61 | 1 | Julien Enselme | Uniquement si problème de passation au niveau de l'administration d'un site, et sur demande explicite de celui-ci. |
62 | 1 | Julien Enselme | <pre> |
63 | 1 | Julien Enselme | <code> |
64 | 1 | Julien Enselme | drush upwd mon_utilisateur --password="mon_nvo_mot-de-passe" |
65 | 1 | Julien Enselme | </code> |
66 | 1 | Julien Enselme | </pre> |
67 | 1 | Julien Enselme | |
68 | 9 | Julien Enselme | h2. Changer les rôles d'un utilisateur |
69 | 1 | Julien Enselme | |
70 | 1 | Julien Enselme | Idem, uniquement sur demande explicite de celui-ci ! |
71 | 1 | Julien Enselme | |
72 | 5 | Julien Enselme | * <code> drush urol "administrator" mon_utilisateur </code> : donne le rôle "administrator" à l'utilisateur mon_utilisateur |
73 | 1 | Julien Enselme | * <code> drush urrol "administrator" mon_utilisateur </code> : retire le rôle "administrator" à l'utilisateur mon_utilisateur |
74 | 1 | Julien Enselme | |
75 | 6 | Julien Enselme | Pour devenir temporairement administrateur sur un site ou permettre à l’utilisateur d’id 1 de changer son mot de passe : <code>drush uli</code>. Cette commande retourne un lien à copier/coller dans son navigateur. |
76 | 6 | Julien Enselme | |
77 | 16 | Julien Enselme | h1. Manipulation des bases de données |
78 | 16 | Julien Enselme | |
79 | 16 | Julien Enselme | h2. Sauvegarder une base de données |
80 | 16 | Julien Enselme | |
81 | 16 | Julien Enselme | Pour les sites drupal 6, utiliser le script @dump_site NOM_DU_SITE@. |
82 | 16 | Julien Enselme | |
83 | 16 | Julien Enselme | Pour les sites drupal 7 qui sont dans leur base de données, utiliser la commande @drush sql-dump --result-file="FICHIER"@. Par défaut, cette commande affiche la base de données dans le terminal. |
84 | 16 | Julien Enselme | |
85 | 16 | Julien Enselme | h2. Revenir sur une mise à jour qui a échoué |
86 | 1 | Julien Enselme | |
87 | 1 | Julien Enselme | Pour revenir sur une mise à jour, il faut rétablir la base de données telle qu'elle était avant la mise à jour. |
88 | 1 | Julien Enselme | Cela suppose évidemment d'avoir fait une sauvegarde de la base de donnée avant :p |
89 | 1 | Julien Enselme | Dans le cas d'une grosse base de données comme la notre, phpmyadmin n'est pas une solution viable, il faut donc utiliser directement le sql en ligne de commande ou drush, bien entendu ^^ |
90 | 1 | Julien Enselme | |
91 | 1 | Julien Enselme | <pre> |
92 | 1 | Julien Enselme | <code> |
93 | 1 | Julien Enselme | drush sqlq < ~/sauvegardes/12345.sql |
94 | 1 | Julien Enselme | </code> |
95 | 1 | Julien Enselme | </pre> |
96 | 1 | Julien Enselme | |
97 | 1 | Julien Enselme | C'est l'équivalent sql de : |
98 | 1 | Julien Enselme | <pre> |
99 | 1 | Julien Enselme | <code> |
100 | 1 | Julien Enselme | mysql -h localhost -u root -p mabase < ~/sauvegardes/12345.sql |
101 | 1 | Julien Enselme | </code> |
102 | 1 | Julien Enselme | </pre> |
103 | 1 | Julien Enselme | |
104 | 1 | Julien Enselme | Explications : je me connecte au serveur _localhost_ avec le nom d'utilisateur _root_ et je veux écraser la base de donnée _mabase_ en y injectant le code sql généré par ma sauvegarde dans le fichier ~/sauvegardes/12345.sql |
105 | 1 | Julien Enselme | |
106 | 1 | Julien Enselme | NB : Pour écraser une base, assurez-vous d'avoir des "CREATE TABLE IF NOT EXISTS" dans le fichier de sauvegardes et non seulement "CREATE TABLE". Dans ce dernier cas, il faut supprimer les tables de la bdd avant d'injecter les fichiers sql. |
107 | 1 | Julien Enselme | |
108 | 9 | Julien Enselme | h1. Les alias drush |
109 | 1 | Julien Enselme | |
110 | 9 | Julien Enselme | h2. Les alias de sites |
111 | 1 | Julien Enselme | |
112 | 9 | Julien Enselme | h3. Généralités |
113 | 7 | Julien Enselme | |
114 | 7 | Julien Enselme | Les alias de sites permettent de lancer une commande @drush@ sans être dans le dossier du site, en précisant le nom du site via un alias de la manière suivante : |
115 | 1 | Julien Enselme | <pre> |
116 | 1 | Julien Enselme | <code> |
117 | 1 | Julien Enselme | drush @monsite status |
118 | 1 | Julien Enselme | </code> |
119 | 1 | Julien Enselme | </pre> |
120 | 1 | Julien Enselme | |
121 | 7 | Julien Enselme | Pour connaître la liste de tous les alias et leur syntaxe exacte, lancer <code>drush sa</code> dans le dossier des sites. |
122 | 1 | Julien Enselme | |
123 | 7 | Julien Enselme | NB : l'alias <code>drush @sites</code> permet de lancer la commande drush sur chacun des sites, et effectue une action similaire à [[Scripts_et_taches_planifiees#drushall_and_co|notre script drushall]] sans pour autant le remplacer… |
124 | 1 | Julien Enselme | |
125 | 9 | Julien Enselme | h3. Mettre en place ses alias de script pour des sites locaux |
126 | 8 | Julien Enselme | |
127 | 8 | Julien Enselme | @drush@ crée dans le répertoire de l’utilisateur un dossier @.drush@ qui contient les fichiers de configuration de _drush_. Pour activer les alias drush, créer dans ce dossier un fichier aliases.drushrc.php et placez-y les instructions suivantes (à adapter à votre configuration) : |
128 | 8 | Julien Enselme | <pre> |
129 | 8 | Julien Enselme | <code class="php"> |
130 | 8 | Julien Enselme | <?php |
131 | 8 | Julien Enselme | |
132 | 8 | Julien Enselme | $aliases['toto'] = array( |
133 | 8 | Julien Enselme | 'uri' => 'toto.local', |
134 | 8 | Julien Enselme | 'root' => '/var/www/local', |
135 | 8 | Julien Enselme | ); |
136 | 8 | Julien Enselme | </code> |
137 | 8 | Julien Enselme | </pre> |
138 | 8 | Julien Enselme | |
139 | 1 | Julien Enselme | Vous pouvez désormais appliquer une commande sur toto en utilisant <code>drush @toto CMD</code>. |
140 | 8 | Julien Enselme | |
141 | 9 | Julien Enselme | h3. Mettre en place ses alias de script pour des sites distants |
142 | 8 | Julien Enselme | |
143 | 1 | Julien Enselme | Marre de devoir vous connecter sur la machine où votre drupal est installé ? Alors les alias distants sont fait pour vous. Il vous permette depuis votre machine local d’administrer les sites installés sur une autre machine. Utiliser une clé ssh semble tout à fait adapter pour ne pas avoir à taper le mot de passe tout le temps. Pour cela, dans le fichier ~/.drush/aliases.drushrc.php entrer le code suivant (donné en exemple pour assos) : |
144 | 8 | Julien Enselme | |
145 | 8 | Julien Enselme | <pre> |
146 | 8 | Julien Enselme | <code class="php"> |
147 | 8 | Julien Enselme | $aliases['sitedistant'] = array( |
148 | 8 | Julien Enselme | 'uri' => 'assos.centrale-marseille.fr', |
149 | 8 | Julien Enselme | 'root' => '/users/guest/assos/htmltest', |
150 | 8 | Julien Enselme | 'remote-user' => 'assos', |
151 | 8 | Julien Enselme | 'remote-host' => 'sas1.centrale-marseille.fr', |
152 | 8 | Julien Enselme | ); |
153 | 8 | Julien Enselme | </code> |
154 | 8 | Julien Enselme | </pre> |
155 | 8 | Julien Enselme | |
156 | 13 | Julien Enselme | {{important(Il ne faut surtout pas mettre le chemin du dossier du site avec la clé _root_, sinon les commandes drush distantes ne fonctionnent pas (même si c’est tentant car facilite la synchronisation des fichiers))}} |
157 | 13 | Julien Enselme | |
158 | 9 | Julien Enselme | h2. Les alias de scripts |
159 | 1 | Julien Enselme | |
160 | 1 | Julien Enselme | Il est également possible de créer des commandes drush personnalisées en utilisant les alias. On peut alors regrouper plusieurs actions souvent effectuées à la suite, voire même des scripts entiers, dans une commande drush. |
161 | 1 | Julien Enselme | Voir ceci [[Scripts_et_taches_planifiees#Liste-des-alias-drush-à-disposition|la liste des alias drush créés par et pour le club drupal]]. |
162 | 1 | Julien Enselme | |
163 | 17 | Florent Torregrosa | Il a été décidé de ne plus passer par les alias de scripts mais de faire des scripts à la place afin d'uniformiser la manière de d'entretenir l'installation multi-assos. |
164 | 17 | Florent Torregrosa | |
165 | 17 | Florent Torregrosa | {{warning(à ne plus utiliser)}} |
166 | 17 | Florent Torregrosa | |
167 | 10 | Julien Enselme | h1. Les commandes pour dupliquer un site |
168 | 10 | Julien Enselme | |
169 | 10 | Julien Enselme | Drush est tout à fait capable de répliquer un site distant sur votre machine ou un site local sur une machine distante. *Il faut avoir paramétré les alias drush avant*. Pour cela, il suffit d’utiliser les commandes suivantes : |
170 | 14 | Julien Enselme | * <code>rush -y rsync @${site}2:%files @${site}:%files</code> pour synchroniser les fichiers. Visiblement tenter de synchroniser autre chose (l’arbre complet par exemple) n’est pas possible. Il est préférable d’utiliser du rsync classique. Si vous synchroniser sur un site local, les fichiers seront bien dans _sites_ mais le dossier s’appellera %files. Si le % est omis, les fichiers seront dans _sites/files/files_. |
171 | 11 | Julien Enselme | * <code>drush -y sql-sync @${site}2 @${site}</code> pour dupliquer la base de données. |
172 | 10 | Julien Enselme | |
173 | 9 | Julien Enselme | h1. Agir sur tous les sites d'un coup |
174 | 1 | Julien Enselme | |
175 | 1 | Julien Enselme | Pour administrer tous les sites du multi-site en une seule fois, nous avons créé le script [[Scripts_et_taches_planifiees#drushall-and-co|drushall]]. L'alias <code>drush @sites</code> peut également être utilisés dans certains cas. |