Ansible Роль: Drush

Устанавливает Drush, оболочку командной строки и интерфейс сценариев для Drupal, на любой системе Linux или UNIX.

Требования

PHP должен быть установлен на системе перед запуском этой роли (рекомендуемая роль: geerlingguy.php).

Глобальная установка Composer требует, чтобы Composer также был установлен на системе (рекомендуемая роль: geerlingguy.composer).

Установка из источника дополнительно требует, чтобы Git и Composer также были установлены на системе (рекомендуемые роли: geerlingguy.git и geerlingguy.composer).

Переменные Роли

Доступные переменные перечислены ниже с значениями по умолчанию (см. defaults/main.yml):

Drush Launcher

Drush Launcher — это небольшая обертка вокруг Drush для вашего глобального $PATH.

Это рекомендованный способ использования drush, но есть ситуации, когда вы можете захотеть установить и запустить Drush глобально без использования Drush Launcher. Следующие переменные контролируют установку Drush Launcher:

drush_launcher_install: true

Установите на no, если не хотите устанавливать лаунчер.

drush_launcher_version: "0.10.1"

Версия Drush Launcher, которую нужно установить. Это должно точно соответствовать доступному релизу Drush Launcher.

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

URL, по которому будет загружен файл Drush Launcher phar.

drush_launcher_path: /usr/local/bin/drush

Путь, по которому drush будет установлен и доступен в вашей системе. Должен находиться в $PATH вашего пользователя, чтобы вы могли выполнять команды просто с помощью drush вместо полного пути.

Глобальная установка Drush через Composer

Некоторым людям необходимо иметь полный доступ к drush глобально, и эта роль позволяет глобальную установку Drush через Composer. Если вы используете эту опцию, убедитесь, что у вас установлен Composer!

drush_composer_global_install: false

Установите на yes (и установите drush_launcher_install на false), если хотите установить drush глобально с помощью Composer.

drush_composer_version: "~11.0"

Ограничение версии для глобальной установки Drush.

drush_composer_update: false

Запускать ли composer update drush/drush, чтобы убедиться, что установленная глобальная версия Drush является последней.

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

Глобальный путь, где Composer устанавливает глобальные бинарники, и путь, в который вы хотите поместить бинарный файл drush.

ПРИМЕЧАНИЕ: Глобальная установка Composer является глобальной _для пользователя, под которым установлен Drush_—например, если вы установите глобально, используя пользователя root, drush будет работать правильно только как root или при использовании sudo.

Переменные для установки из источника (Git).

Вы также можете установить Drush из источника, если вам нужна последняя версия или вам нужна конкретная версия, которую нельзя установить с помощью Composer.

drush_install_from_source: false

Установите на yes (и установите drush_launcher_install на false), если хотите установить drush глобально, используя исходный код Drush.

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

Местоположение всей установки drush (включает все вспомогательные файлы, а также исполняемый файл drush).

drush_source_install_version: "11.x"

Версия Drush для установки (например, "master" для последней версии, "11.x", "10.x", "6.2.0"). Это должна быть строка, поскольку она ссылается на ветку git, тег или хэш коммита.

drush_keep_updated: false
drush_force_update: false

Следить ли за обновлением Drush до последней ревизии ветки, указанной в drush_version, и следует ли принудительно обновить (например, перезаписать локальные изменения в репозитории drush).

drush_force_composer_install: false

Используйте это, если вы получаете сообщение об ошибке при развертывании, например, Unable to load autoload.php. Run composer install to fetch dependencies and write this file. Это заставит выполнить composer install в каталоге Drush.

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

Эти опции являются самыми безопасными для избежания ограничений по количеству запросов API GitHub при установке Drush и могут быть очень полезны при работе с зависимостями/установкой, но сборки можно значительно ускорить, изменив первый параметр на --prefer-dist.

drush_clone_depth: 1

Клонировать ли весь репозиторий (по умолчанию) или указать количество предыдущих коммитов для меньшего и более быстрого клона.

Зависимости

Нет.

Пример Плейбука

- hosts: servers
  roles:
    - geerlingguy.drush

После запуска плейбука команда drush будет доступна из обычных системных учетных записей.

Лицензия

MIT / BSD

Информация об Авторе

Эта роль была создана в 2014 году Джеффом Гирлингом, автором Ansible for DevOps.