Rol de Ansible: Drush

Instala Drush, una interfaz de línea de comandos y scripting para Drupal, en cualquier sistema Linux o UNIX.

Requisitos

PHP debe estar instalado en el sistema antes de ejecutar este rol (rol sugerido: geerlingguy.php).

La instalación global de Composer requiere que Composer también esté instalado en el sistema (rol sugerido: geerlingguy.composer).

La instalación desde el código fuente requiere adicionalmente que Git y Composer también estén instalados en el sistema (roles sugeridos: geerlingguy.git y geerlingguy.composer).

Variables del Rol

Las variables disponibles se enumeran a continuación, junto con sus valores predeterminados (ver defaults/main.yml):

Lanzador de Drush

Drush Launcher es un pequeño envoltorio alrededor de Drush para tu $PATH global.

Es la forma recomendada de usar drush, pero hay algunas situaciones en las que podrías desear instalar y ejecutar Drush globalmente sin usar Drush Launcher. Las siguientes variables controlan la instalación del Lanzador de Drush:

drush_launcher_install: true

Configúralo en no si no quieres que se instale el lanzador.

drush_launcher_version: "0.10.1"

La versión del Lanzador de Drush que se debe instalar. Debe coincidir exactamente con un lanzamiento de Drush Launcher disponible.

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

La URL desde donde se descargará el archivo phar del Lanzador de Drush.

drush_launcher_path: /usr/local/bin/drush

La ruta donde se instalará Drush y estará disponible en tu sistema. Debe estar en el $PATH de tu usuario para que puedas ejecutar comandos simplemente con drush en vez de usar la ruta completa.

Instalación global de Drush a través de Composer

Algunas personas necesitan tener todo el poder de drush disponible globalmente, y este rol permite la instalación global de Drush a través de Composer. Si usas esta opción, asegúrate de tener Composer instalado.

drush_composer_global_install: false

Ponlo en yes (y establece drush_launcher_install en false) si deseas instalar drush globalmente usando Composer.

drush_composer_version: "~11.0"

La restricción de versión para la instalación global de Drush.

drush_composer_update: false

Si ejecutar composer update drush/drush para asegurarte de que la versión de Drush instalada globalmente sea la última.

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

La ruta global donde Composer instala binarios globales, y la ruta donde deseas que se coloque el binario de drush.

NOTA: La instalación 'global' de Composer es global _para el usuario bajo el cual se instala Drush_—por ejemplo, si instalas globalmente usando el usuario root, drush solo funcionará correctamente como root o al usar sudo.

Variables usadas para la instalación desde código fuente (Git).

También puedes instalar Drush desde el código fuente si necesitas una versión de última generación, o si necesitas una versión específica que no se puede instalar a través de Composer.

drush_install_from_source: false

Ponlo en yes (y establece drush_launcher_install en false) si deseas instalar drush globalmente usando el código fuente de Drush.

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

La ubicación de toda la instalación de Drush (incluye todos los archivos de soporte, así como el archivo ejecutable drush).

drush_source_install_version: "11.x"

La versión de Drush a instalar (ejemplos: "master" para la última versión, "11.x", "10.x", "6.2.0"). Esto debe ser una cadena ya que se refiere a una rama de git, etiqueta o hash de commit.

drush_keep_updated: false
drush_force_update: false

Si mantener Drush actualizado con la última revisión de la rama especificada por drush_version, y si forzar la actualización (por ejemplo, sobrescribir modificaciones locales en el repositorio de Drush).

drush_force_composer_install: false

Usa esto si recibes un mensaje de error al aprovisionar como Unable to load autoload.php. Run composer install to fetch dependencies and write this file. Forzará un composer install dentro del directorio de Drush.

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

Estas opciones son las más seguras para evitar los límites de tasa de la API de GitHub al instalar Drush y pueden ser muy útiles al trabajar en dependencias/instalación, pero las construcciones pueden acelerarse sustancialmente al cambiar la primera opción a --prefer-dist.

drush_clone_depth: 1

Si clonar todo el repositorio (por defecto), o especificar el número de commits anteriores para una clonación más pequeña y rápida.

Dependencias

Ninguna.

Ejemplo de Playbook

- hosts: servers
  roles:
    - geerlingguy.drush

Después de ejecutar el playbook, el comando drush será accesible desde cuentas de sistema normales.

Licencia

MIT / BSD

Información del Autor

Este rol fue creado en 2014 por Jeff Geerling, autor de Ansible for DevOps.