Rola Ansible: Drush

Instaluje Drush, interfejs wiersza poleceń i skryptów dla Drupala, na dowolnym systemie Linux lub UNIX.

Wymagania

PHP musi być zainstalowany na systemie przed uruchomieniem tej roli (sugerowana rola: geerlingguy.php).

Globalna instalacja za pomocą Composera wymaga także, aby Composer był zainstalowany na systemie (sugerowana rola: geerlingguy.composer).

Instalacja ze źródła wymaga dodatkowo, aby Git i Composer były zainstalowane na systemie (sugerowane role: geerlingguy.git i geerlingguy.composer).

Zmienne Roli

Dostępne zmienne są wymienione poniżej, wraz z wartościami domyślnymi (zobacz defaults/main.yml):

Drush Launcher

Drush Launcher to mały wrapper wokół Drush dla twojego globalnego $PATH.

To jest zalecany sposób użycia drush, ale są sytuacje, w których możesz chcieć zainstalować i uruchomić Drush globalnie bez użycia Drush Launcher. Poniższe zmienne kontrolują instalację Drush Launchera:

drush_launcher_install: true

Ustaw na no, jeśli nie chcesz, aby launcher był zainstalowany.

drush_launcher_version: "0.10.1"

Wersja Drush Launchera do zainstalowania. Powinna dokładnie odpowiadać dostępnej wersji Drush Launchera.

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

URL, z którego zostanie pobrany plik phar Drush Launchera.

drush_launcher_path: /usr/local/bin/drush

Ścieżka, gdzie drush zostanie zainstalowany i dostępny w twoim systemie. Powinna znajdować się w $PATH twojego użytkownika, abyś mógł uruchamiać polecenia po prostu używając drush zamiast pełnej ścieżki.

Globalna instalacja Drush za pomocą Composera

Niektórzy użytkownicy potrzebują pełnej mocy drush dostępnej globalnie, a ta rola pozwala na globalną instalację Drush za pomocą Composera. Upewnij się, że masz zainstalowanego Composera!

drush_composer_global_install: false

Ustaw na yes (i ustaw drush_launcher_install na false), jeśli chcesz zainstalować drush globalnie za pomocą Composera.

drush_composer_version: "~11.0"

Ograniczenie wersji dla globalnej instalacji Drush.

drush_composer_update: false

Czy uruchomić composer update drush/drush, aby upewnić się, że zainstalowana globalnie wersja Drush jest najnowsza.

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

Globalna ścieżka, w której Composer instaluje globalne binaria oraz ścieżka, w której chcesz umieścić binarkę drush.

UWAGA: Globalna instalacja Composera jest globalna dla użytkownika, pod którym Drush jest zainstalowany — np. jeśli instalujesz globalnie jako użytkownik root, drush będzie działać poprawnie tylko jako root lub przy użyciu sudo.

Zmienne używane do instalacji ze źródła (Git).

Możesz także zainstalować Drush ze źródła, jeśli potrzebujesz wersji w wersji beta lub specyficznej wersji, której nie da się zainstalować za pomocą Composera.

drush_install_from_source: false

Ustaw na yes (i ustaw drush_launcher_install na false), jeśli chcesz zainstalować drush globalnie za pomocą kodu źródłowego Drush.

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

Lokalizacja całej instalacji drush (zawiera wszystkie pliki pomocnicze, a także plik wykonywalny drush).

drush_source_install_version: "11.x"

Wersja Drush do zainstalowania (przykłady: "master" dla najbardziej aktualnej wersji, "11.x", "10.x", "6.2.0"). Powinno to być ciągiem, ponieważ odnosi się do gałęzi git, tagu lub identyfikatora commit.

drush_keep_updated: false
drush_force_update: false

Czy utrzymywać Drush w aktualności z najnowszą wersją gałęzi określonej przez drush_version, oraz czy wymusić aktualizację (np. nadpisać lokalne modyfikacje repozytorium drush).

drush_force_composer_install: false

Użyj tego, jeśli otrzymasz komunikat o błędzie podczas konfiguracji, taki jak Nie można załadować autoload.php. Uruchom composer install, aby pobrać zależności i napisać ten plik. Wymusi to composer install w katalogu Drush.

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

Te opcje są najbezpieczniejsze w unikaniu limitów API GitHub podczas instalacji Drush i mogą być bardzo pomocne podczas pracy z zależnościami/instalacją, ale budowy mogą być znacznie przyspieszone przez zmianę pierwszej opcji na --prefer-dist.

drush_clone_depth: 1

Czy klonować całe repozytorium (domyślnie), czy określić liczbę poprzednich commitów dla mniejszego i szybszego klonu.

Zależności

Brak.

Przykład Playbooka

- hosts: servers
  roles:
    - geerlingguy.drush

Po uruchomieniu playbooka polecenie drush będzie dostępne z normalnych kont systemowych.

Licencja

MIT / BSD

Informacje o autorze

Ta rola została stworzona w 2014 roku przez Jeffa Geerlinga, autora Ansible for DevOps.