Ansible Rolle: Drush

Installiert Drush, eine Kommandozeilenschnittstelle und Skripting-Schnittstelle für Drupal, auf jedem Linux- oder UNIX-System.

Anforderungen

PHP muss auf dem System installiert sein, bevor diese Rolle ausgeführt wird (vorgeschlagene Rolle: geerlingguy.php).

Eine globale Composer-Installation erfordert, dass Composer ebenfalls auf dem System installiert ist (vorgeschlagene Rolle: geerlingguy.composer).

Die Installation aus dem Quellcode erfordert zusätzlich, dass Git und Composer auf dem System installiert sind (vorgeschlagene Rollen: geerlingguy.git und geerlingguy.composer).

Rollenvariablen

Verfügbare Variablen sind unten aufgeführt, zusammen mit Standardwerten (siehe defaults/main.yml):

Drush Launcher

Drush Launcher ist eine kleine Wrapper-Anwendung um Drush für deinen globalen $PATH.

Es ist die empfohlene Methode, drush zu verwenden, aber es gibt Situationen, in denen du möglicherweise Drush global ohne den Drush Launcher installieren und ausführen möchtest. Die folgenden Variablen steuern die Installation des Drush Launchers:

drush_launcher_install: true

Setze auf nein, wenn du den Launcher nicht installieren möchtest.

drush_launcher_version: "0.10.1"

Die zu installierende Version des Drush Launchers. Diese sollte genau mit einem verfügbaren Drush Launcher Release übereinstimmen.

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

Die URL, von der die Drush Launcher Phar-Datei heruntergeladen wird.

drush_launcher_path: /usr/local/bin/drush

Der Pfad, unter dem Drush installiert und für dein System verfügbar sein wird. Sollte im $PATH des Benutzers enthalten sein, damit du Befehle einfach mit drush anstatt des vollen Pfades ausführen kannst.

Drush globale Installation über Composer

Einige Leute benötigen die volle Leistungsfähigkeit von drush global, und diese Rolle ermöglicht die globale Installation von Drush über Composer. Wenn du diese Option verwendest, stelle sicher, dass Composer installiert ist!

drush_composer_global_install: false

Setze auf ja (und setze drush_launcher_install auf false), wenn du drush global mit Composer installieren möchtest.

drush_composer_version: "~11.0"

Die Versionsbeschränkung für die globale Drush-Installation.

drush_composer_update: false

Ob composer update drush/drush ausgeführt werden soll, um sicherzustellen, dass die global installierte Drush-Version die neueste ist.

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

Der globale Pfad, wo Composer globale Binärdateien installiert, und der Pfad, in dem du die drush-Binärdatei platzieren möchtest.

HINWEIS: Die globale Installation über Composer ist global _für den Benutzer, unter dem Drush installiert ist_—z.B. wenn du global mit dem Root-Benutzer installierst, funktioniert drush nur richtig als root oder bei Verwendung von sudo.

Variablen für die Installation aus dem Quellcode (Git)

Du kannst Drush auch aus dem Quellcode installieren, wenn du eine neueste Version benötigst oder wenn du eine bestimmte Version benötigst, die nicht über Composer installiert werden kann.

drush_install_from_source: false

Setze auf ja (und setze drush_launcher_install auf false), wenn du drush global mit dem Drush-Quellcode installieren möchtest.

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

Der Speicherort der gesamten Drush-Installation (beinhaltet alle unterstützenden Dateien sowie die drush-ausführbare Datei).

drush_source_install_version: "11.x"

Die zu installierende Version von Drush (Beispiele: "master" für die neueste Version, "11.x", "10.x", "6.2.0"). Dies sollte eine Zeichenkette sein, da sie sich auf einen Git-Zweig, ein Tag oder einen Commit-Hash bezieht.

drush_keep_updated: false
drush_force_update: false

Ob Drush auf dem neuesten Stand mit der neuesten Revision des durch drush_version angegebenen Zweigs gehalten werden soll und ob das Update erzwungen werden soll (z.B. lokale Änderungen am Drush-Repository überschreiben).

drush_force_composer_install: false

Verwende dies, wenn du eine Fehlermeldung beim Bereitstellen erhältst wie Unable to load autoload.php. Run composer install to fetch dependencies and write this file. Es wird ein composer install im Drush-Verzeichnis erzwungen.

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

Diese Optionen sind am sichersten, um die GitHub-API-Rategrenzen beim Installieren von Drush zu vermeiden und können sehr hilfreich sein, wenn du an Abhängigkeiten/Installationen arbeitest, aber die Builds können erheblich beschleunigt werden, indem die erste Option auf --prefer-dist geändert wird.

drush_clone_depth: 1

Ob das gesamte Repository (standardmäßig) geklont werden soll oder die Anzahl der vorhergehenden Commits für einen kleineren und schnelleren Klon angegeben werden soll.

Abhängigkeiten

Keine.

Beispiel-Playbook

- hosts: servers
  roles:
    - geerlingguy.drush

Nachdem das Playbook ausgeführt wurde, wird der Befehl drush von normalen Systembenutzern zugänglich sein.

Lizenz

MIT / BSD

Autor Informationen

Diese Rolle wurde 2014 von Jeff Geerling erstellt, Autor von Ansible for DevOps.