DESCATIVADO - Rol de Ansible: Bot IRC PHP Phergie

DESCATIVADO: Este rol ha sido desactivado, ya que geerlingguy ya no usa Phergie y no continuará manteniendo el rol.

Instala Phergie, un bot IRC PHP en sistemas Linux RHEL/CentOS y Debian/Ubuntu.

Para usar Phergie, puedes ejecutar php phergie.php desde el directorio en el que Phergie está instalado (configura esto con la variable phergie_install_path). Es posible que desees ejecutar Phergie en segundo plano y registrar la salida para poder verificar problemas y almacenar el historial de chat con un comando como:

$ nohup php /ruta/a/phergie.php > /ruta/a/log 2>&1&

Requisitos

• Git (rol recomendado: geerlingguy.git).
• PHP (rol recomendado: geerlingguy.php) - se recomienda tener php, php-pdo y php-sqlite.

Variables del Rol

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

phergie_install_path: "/home/{{ ansible_ssh_user }}/phergie"
phergie_user: "{{ ansible_ssh_user }}"

La ubicación donde se instalará Phergie y el usuario con el que se instalará y probablemente se ejecutará.

phergie_timezone: America/Chicago

La zona horaria que Phergie usará al realizar acciones basadas en la fecha.

phergie_connections:
  - {
    host: 'irc.freenode.net',
    port: '6667',
    username: 'PhergieExample',
    realname: 'Phergie Example Bot',
    nick: 'PhergieExample'
  }

Una lista de objetos de conexión; Phergie puede conectarse a múltiples hosts IRC, pero generalmente una conexión es suficiente.

phergie_autojoin_channels:
  - '#example'

Una lista de canales a los que Phergie se unirá después de conectarse con éxito al servidor IRC.

phergie_command_prefix: ''

Si deseas que Phergie solo responda a comandos con un prefijo (como !karma [palabra clave] en lugar de karma [palabra clave]), establece un prefijo aquí.

phergie_ui_enabled: 'true'

Si desea mostrar los eventos del bot Phergie en la consola mientras Phergie está en ejecución (útil para depuración o para comprobar la actividad del bot en los registros).

phergie_plugins:
  - AltNick
  - AutoJoin
  - Beer
  - Help
  - Karma
  - Lart
  - Php
  - Ping
  - PingPong
  - Pong
  - Prioritize
  - Quit
  - Remind
  - Serve

Una lista de plugins de Phergie para cargar. Consulta la lista completa aquí: https://github.com/phergie/phergie/tree/master/Phergie/Plugin.

phergie_altnicks: []

Una lista de apodos alternativos que Phergie usará si el apodo principal está ocupado (requiere AltNick en phergie_plugins).

phergie_wunderground_api_key: ''

La clave de API de Weather Underground para usar (requiere Wunderground en phergie_plugins).

phergie_karma_db_location: ''

Una ruta a una base de datos SQLite que Phergie usará si Karma está en phergie_plugins. Es útil usar una base de datos fuera de la carpeta de instalación de Phergie para que la base de datos no se borre si actualizas Phergie mediante git pull.

Dependencias

• geerlingguy.git

Ejemplo de Playbook

- hosts: ircbot
  vars_files:
    - vars/main.yml
  roles:
    - geerlingguy.phergie

Dentro de vars/main.yml:

phergie_connections:
  - {
    host: 'irc.freenode.net',
    port: '6667',
    username: 'PhergieExample',
    realname: 'Phergie Example Bot',
    nick: 'PhergieExample'
  }

Licencia

MIT / BSD

Información del Autor

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