geerlingguy.composer

Descripción general Versiones Perspectivas

Rol de Ansible: Composer

Instala Composer, el gestor de dependencias de PHP, en cualquier sistema Linux o UNIX.

Requisitos

php (versión 5.4+) debe estar instalado y funcionando (puedes usar el rol geerlingguy.php para instalarlo).
git debe estar instalado y funcionando (puedes usar el rol geerlingguy.git para instalarlo).

Variables del Rol

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

composer_path: /usr/local/bin/composer

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

composer_keep_updated: false

Configura esto en true para actualizar Composer a la última versión cada vez que se ejecute el playbook.

composer_home_path: '~/.composer'
composer_home_owner: root
composer_home_group: root

La ruta y propiedad del directorio COMPOSER_HOME; este es el directorio donde se instalarán los paquetes globales.

composer_version: ''

Puedes instalar una versión específica de Composer, por ejemplo, composer_version: '1.0.0-alpha11'. Si se deja vacío, se instalará la última versión de desarrollo. Ten en cuenta que composer_keep_updated sobrescribirá esta variable, ya que siempre instalará la última versión de desarrollo.

composer_version_branch: '--2'

Puedes elegir qué rama principal de Composer deseas usar. El valor predeterminado es --2. Ten en cuenta que composer_keep_updated actualizará la última versión disponible para esta rama.

composer_global_packages: []

Una lista de paquetes a instalar globalmente (usando composer global require). Si deseas instalar algún paquete globalmente, añade un ítem a la lista con un diccionario que incluya el nombre del paquete y su release, por ejemplo, - { name: phpunit/phpunit, release: "4.7.*" }. La 'release' es opcional y, por defecto, es @stable.

composer_add_to_path: true

Si es true, y si hay algún composer_global_packages configurado, el directorio vendor/bin dentro de composer_home_path se añadirá al $PATH predeterminado del sistema (para todos los usuarios).

composer_project_path: /path/to/project

Ruta a un proyecto de Composer.

composer_add_project_to_path: false

Si es true, y si has configurado un composer_project_path, el directorio vendor/bin dentro de composer_project_path se añadirá al $PATH predeterminado del sistema (para todos los usuarios).

composer_github_oauth_token: ''

Token de OAuth de GitHub, utilizado para evitar errores de límite de tasa en la API de GitHub al construir y reconstruir aplicaciones usando Composer. Sigue las instrucciones de GitHub para Crear un token de acceso personal si te encuentras con estos errores de límite de tasa.

php_executable: php

El nombre del ejecutable o la ruta completa al ejecutable de PHP. Por defecto, se configura como php si no sobrescribes la variable.

Permanecer en Composer 1

Mientras los proyectos se actualizan para ser compatibles con Composer 2, puede ser útil usar Composer 1. Para hacer eso, configura estas variables:

composer_version_branch: ''
composer_version: '1.10.12'

Dependencias

Ninguna (pero asegúrate de haber instalado PHP; se recomienda el rol geerlingguy.php).

Ejemplo de Playbook

- hosts: servers
  roles:
    - geerlingguy.composer

Después de que se ejecute el playbook, composer se colocará en /usr/local/bin/composer (esta ubicación es configurable) y será accesible a través de cuentas de sistema normales.