shaneholloman.composer

Descripción general Versiones Perspectivas

Rol de Ansible: `composer`

Instala Composer, el Administrador de Dependencias de PHP, en cualquier sistema Linux o UNIX.

Requisitos

php (versión 5.4 o superior) debe estar instalado y funcionando (puedes usar el rol shaneholloman.php para instalarlo).
git debe estar instalado y funcionando (puedes usar el rol shaneholloman.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

Establece 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 de COMPOSER_HOME y la propiedad del directorio; 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 anulará 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 para instalar globalmente (usando composer global require). Si deseas instalar algún paquete globalmente, agrega un elemento a la lista con un diccionario que contenga el nombre del paquete y una versión, por ejemplo, - { name: phpunit/phpunit, release: "4.7.*" }. La 'versión' 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 OAuth de GitHub, utilizado para evitar errores de limitación de tasa de 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. Se predetermina a php si no anulas la variable.

Permanecer en Composer 1

Mientras los proyectos se actualizan para soportar Composer 2, puede ser útil ejecutar Composer 1 en su lugar. Para hacerlo, establece estas variables:

composer_version_branch: ''
composer_version: '1.10.12'

Dependencias

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

Ejemplo de Playbook

- hosts: servers
  roles:
    - shaneholloman.composer

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