Créer vos distributions Drupal : introduction au module Drush make

Drush make permet de déployer rapidement sur un serveur tous les fichiers nécessaires à l'installation d'un site Drupal personnalisé. C'est à dire qu'on va pouvoir installer, grâce à un fichier d'extension .make, les fichiers core Drupal, des thèmes, des modules, des librairies externes, etc...
Avec drush make, on rentre dans l'univers des "distributions" Drupal.

Pas facile d'expliquer en trois lignes de français les possibilités de cette extension de Drush, rien ne vaut l'excellente intro se trouvant sur la page du projet :

Drush make is an extension to drush that can create a ready-to-use drupal site, pulling sources from various locations. It does this by parsing a flat text file (similar to a drupal .info file) and downloading the sources it describes. In practical terms, this means that it is possible to distribute a complicated Drupal distribution as a single text file.

Pour faire fonctionner Drush make, il faut avoir installé le module Drush. Vous pouvez consulter à ce sujet mes deux précédents articles :
- module Drupal : Drush : part 1 : comment l'installer et l'utiliser
- module Drupal : Drush : part 2 : installation en local sous MAMP (MacOSX)

Installation de drush make

Je vais ici reprendre mon environnement local sous MAMP et installer drush make dans mon home /Users/robin
Les instructions de base se trouvent dans le fichier INSTALL.txt du module.

Dans le screen ci-dessous, je me place dans mon home /Users/robin et je créé un répertoire .drush avec la commande sudo mkdir .drush
je liste ensuite mon Home avec ls -al pour vérifier la création du .drush

Ensuite, je transfert le dossier drush_make du module dans le .drush précédemment créé avec la commande :

sudo mv /Users/robin/drush_make /Users/robin/.drush

Pour vérifier ensuite que Drush make fonctionne, il suffit de lancer la commande drush ou drush help. Si tout va bien vous verrez de nouvelles commandes disponibles dans le listing : make, generate makefile, etc ...

Génération d'un .make avec la commande $ drush generate makefile

Vous pouvez créer vous-même vos fichiers .make pour déployer votre distribution personnalisée. Le README.txt du module vous montre quelques exemples et vous indique la nomenclature à respecter.

Mes Drush make peu aussi tenter de le faire pour vous à partir d'un site drupal déjà installé.

Pour ce premier exemple, j'ai un site drupal déjà installé avec quelques modules supplémentaires.
Je me place à la racine du site (simplebase.drupal) et lance la commande :

drush generate makefile /Users/robin/MaDistributionDrupal.make

(NB: "MaDistributionDrupal" est à remplacer par le nom de votre choix, notez que je précise aussi l'endroit où doit être placé le .make après génération, ici dans mon Home /Users/robin/)

Mon fichier a bien était généré dans mon home :

... et il ressemble à ceci :

; This file was auto-generated by drush_make
core = 6.x

projects[] = "drupal"
; Modules
projects[] = "admin_menu"
projects[] = "auto_nodetitle"
projects[] = "jquery_update"
projects[] = "pathauto"
projects[] = "suggestedterms"
projects[] = "token"
projects[] = "views"

Mettre en place les fichiers avec la commande $ drush make foobar.make

Maintenant que nous avons un .make sous la main, nous allons l'utiliser pour reconstruire un autre site drupal.
Je rappel au passage que vous pouvez créer vous-même vos fichiers .make en suivant les exemples du README.txt du module

Dans mon document root WWW, je créé un nouveau dossier drupaltest qui va accueillir mon nouveau site Drupal. Je me place dedans et je lance la commande drush make en lui indiquant l'emplacement de mon fichier .make :

$ drush make /Users/robin/MaDistributionDrupal.make

Drush make télécharge tous les fichiers, il installe par défaut les modules dans /sites/all/modules et les thèmes dans /sites/all/themes.

Notre distribution est prête et il ne reste plus qu'à lancer le process d'install via son navigateur (n'oubliez pas de créer une base de donnée).

On peut imaginer par la suite des configurations plus complexes avec des .make récupérant des librairies externes, etc... De même, pourquoi ne pas mettre en place un profil d'installation drupal ou proposer un package sur Drupal.org...

Avec Drush + Drush make, vous avez de sérieux outils pour concocter une distribution drupal aux petits oignons.

Ressources Web :

• Mon tag "drush make" sur delicious, vous avez de quoi faire...

Average :

4.75

Average: 4.8 (4 votes)

Your rating : Select ratingAnnulerMauvaisMoyenBonTrès bonExcellent

Your rating: Aucun