Rôle Ansible : Drush

Installe Drush, une interface de ligne de commande et de script pour Drupal, sur n'importe quel système Linux ou UNIX.

Prérequis

PHP doit être installé sur le système avant d'exécuter ce rôle (rôle suggéré : geerlingguy.php).

Une installation globale de Composer nécessite également que Composer soit installé sur le système (rôle suggéré : geerlingguy.composer).

Pour une installation à partir des sources, Git et Composer doivent également être installés sur le système (rôles suggérés : geerlingguy.git et geerlingguy.composer).

Variables du rôle

Les variables disponibles sont listées ci-dessous, avec les valeurs par défaut (voir defaults/main.yml):

Lanceur Drush

Drush Launcher est un petit wrapper autour de Drush pour votre $PATH global.

C'est le moyen recommandé d'utiliser drush, mais il y a des situations où vous voudrez peut-être installer et exécuter Drush globalement sans utiliser Drush Launcher. Les variables suivantes contrôlent l'installation du Lanceur Drush :

drush_launcher_install: true

Mettez à no si vous ne voulez pas que le lanceur soit installé.

drush_launcher_version: "0.10.1"

La version du Lanceur Drush à installer. Cela doit exactement correspondre à une version disponible de Drush Launcher.

drush_launcher_phar_url: https://github.com/drush-ops/drush-launcher/releases/download/{{ drush_launcher_version }}/drush.phar

L'URL à partir de laquelle le fichier phar du Lanceur Drush sera téléchargé.

drush_launcher_path: /usr/local/bin/drush

Le chemin où Drush sera installé et accessible pour votre système. Cela doit être dans le $PATH de votre utilisateur afin que vous puissiez exécuter des commandes simplement avec drush au lieu du chemin complet.

Installation globale de Drush via Composer

Certaines personnes ont besoin d'avoir toute la puissance de drush disponible globalement, et ce rôle permet l'installation globale de Drush via Composer. Si vous utilisez cette option, assurez-vous d'avoir Composer installé !

drush_composer_global_install: false

Mettez à yes (et mettez drush_launcher_install à false) si vous souhaitez installer drush globalement en utilisant Composer.

drush_composer_version: "~11.0"

La contrainte de version pour l'installation globale de Drush.

drush_composer_update: false

Indique si vous souhaitez exécuter composer update drush/drush pour garantir que la version de Drush installée globalement est la plus récente.

drush_composer_global_bin_path: ~/.config/composer/vendor/bin
drush_composer_path: /usr/local/bin/drush

Le chemin global où Composer installe les binaires globaux, et le chemin dans lequel vous souhaitez placer le binaire drush.

REMARQUE : L'installation globale de Composer est globale _pour l'utilisateur sous lequel Drush est installé_—par exemple, si vous installez globalement en utilisant l'utilisateur root, drush fonctionnera correctement uniquement en tant que root ou en utilisant sudo.

Variables utilisées pour l'installation à partir des sources (Git).

Vous pouvez également installer Drush à partir des sources si vous avez besoin d'une version à la pointe, ou si vous avez besoin d'une version spécifique qui ne peut pas être installée via Composer.

drush_install_from_source: false

Mettez à yes (et mettez drush_launcher_install à false) si vous souhaitez installer drush globalement en utilisant le code source de Drush.

drush_source_install_bin_path: /usr/local/bin/drush
drush_source_install_path: /usr/local/share/drush

L'emplacement de l'installation complète de Drush (comprend tous les fichiers de support, ainsi que le fichier exécutable drush).

drush_source_install_version: "11.x"

La version de Drush à installer (exemples : "master" pour la version à la pointe, "11.x", "10.x", "6.2.0"). Cela doit être une chaîne, car cela se réfère à une branche git, un tag ou un hash de commit.

drush_keep_updated: false
drush_force_update: false

Indique s'il faut garder Drush à jour avec la dernière révision de la branche spécifiée par drush_version, et s'il faut forcer la mise à jour (par exemple, écraser les modifications locales du dépôt Drush).

drush_force_composer_install: false

Utilisez cela si vous obtenez un message d'erreur lors de la configuration, comme Impossible de charger autoload.php. Exécutez composer install pour récupérer les dépendances et écrire ce fichier. Cela forcera un composer install dans le répertoire Drush.

drush_composer_cli_options: "--prefer-source --no-interaction"

Ces options sont les plus sûres pour éviter les limites de taux de l'API GitHub lors de l'installation de Drush, et peuvent être très utiles lors de la gestion des dépendances/l'installation, mais les constructions peuvent être considérablement accélérées en changeant la première option en --prefer-dist.

drush_clone_depth: 1

Indique si l'on doit cloner tout le dépôt (par défaut), ou spécifier le nombre de commits précédents pour un clonage plus petit et plus rapide.

Dépendances

Aucune.

Exemple de Playbook

- hosts: servers
  roles:
    - geerlingguy.drush

Après l'exécution du playbook, la commande drush sera accessible à partir des comptes système normaux.

Licence

MIT / BSD

Informations sur l'auteur

Ce rôle a été créé en 2014 par Jeff Geerling, auteur de Ansible for DevOps.