DÉPRÉCIÉ - Rôle Ansible : Bot IRC PHP Phergie

DÉPRÉCIÉ : Ce rôle a été déprécié, car geerlingguy n'utilise plus Phergie et ne continuera pas à maintenir ce rôle.

Installe Phergie, un bot IRC PHP sur les systèmes Linux RHEL/CentOS et Debian/Ubuntu.

Pour utiliser Phergie, vous pouvez exécuter php phergie.php depuis le répertoire où Phergie est installé (définissez cela avec la variable phergie_install_path). Vous pourriez vouloir exécuter Phergie en arrière-plan et enregistrer la sortie pour pouvoir vérifier les problèmes et stocker l'historique de chat avec une commande comme :

$ nohup php /chemin/vers/phergie.php > /chemin/vers/log 2>&1&

Exigences

• Git (rôle recommandé : geerlingguy.git).
• PHP (rôle recommandé : geerlingguy.php) - php, php-pdo, et php-sqlite sont recommandés.

Variables du Rôle

Les variables disponibles sont listées ci-dessous, avec des valeurs par défaut (voir defaults/main.yml) :

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

L'emplacement où Phergie sera installé et l'utilisateur avec lequel Phergie sera installé et probablement exécuté.

phergie_timezone: America/Chicago

Le fuseau horaire que Phergie utilisera pour effectuer des actions basées sur la date.

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

Une liste d'objets de connexion ; Phergie peut se connecter à plusieurs hôtes IRC, mais généralement une seule connexion suffira.

phergie_autojoin_channels:
  - '#exemple'

Une liste de canaux auxquels Phergie rejoindra après une connexion réussie au serveur IRC.

phergie_command_prefix: ''

Si vous souhaitez que Phergie réponde uniquement aux commandes avec un préfixe (comme !karma [mot-clé] au lieu de karma [mot-clé]), définissez un préfixe ici.

phergie_ui_enabled: 'true'

Que Phergie affiche les événements du bot dans la console lorsqu'il est en cours d'exécution (utile pour le débogage ou pour vérifier l'activité du bot dans les journaux).

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

Une liste de plugins Phergie à charger. Voir la liste complète ici : https://github.com/phergie/phergie/tree/master/Phergie/Plugin.

phergie_altnicks: []

Une liste de surnoms alternatifs que Phergie utilisera si le surnom principal est déjà pris (nécessite AltNick dans phergie_plugins).

phergie_wunderground_api_key: ''

La clé API Weather Underground à utiliser (nécessite Wunderground dans phergie_plugins).

phergie_karma_db_location: ''

Un chemin vers une base de données SQLite que Phergie utilisera si Karma est dans phergie_plugins. Il est utile d'utiliser une base de données en dehors du dossier d'installation de Phergie pour que la base de données ne soit pas effacée lors de la mise à jour de Phergie via git pull.

Dépendances

• geerlingguy.git

Exemple de Playbook

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

Dans vars/main.yml :

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

Licence

MIT / BSD

Informations sur l'Auteur

Ce rôle a été créé en 2014 par Jeff Geerling, auteur de Ansible for DevOps.