УСТАРЕВШИЙ - Ansible Роль: Phergie PHP IRC Bot

УСТАРЕВШИЙ: Эта роль устарела, так как geerlingguy больше не использует Phergie и не будет продолжать её сопровождение.

Устанавливает Phergie, PHP IRC бот для систем Linux RHEL/CentOS и Debian/Ubuntu.

Чтобы использовать Phergie, вы можете выполнить php phergie.php из директории, в которой установлен Phergie (установите это с помощью переменной phergie_install_path). Вы можете запустить Phergie в фоновом режиме и записывать вывод, чтобы иметь возможность проверять возможные проблемы и сохранять историю чата с помощью команды:

$ nohup php /path/to/phergie.php > /path/to/log 2>&1&

Требования

• Git (рекомендуемая роль: geerlingguy.git).
• PHP (рекомендуемая роль: geerlingguy.php) - рекомендуется использовать php, php-pdo и php-sqlite.

Переменные роли

Доступные переменные перечислены ниже, вместе с их значениями по умолчанию (см. defaults/main.yml):

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

Местоположение, где будет установлен Phergie, и пользователь, с которым Phergie будет установлен и, скорее всего, запущен.

phergie_timezone: America/Chicago

Часовой пояс, который будет использовать Phergie при выполнении действий с датами.

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

Список объектов соединений; Phergie может подключаться к нескольким IRC хостам, но обычно достаточно одного соединения.

phergie_autojoin_channels:
  - '#example'

Список каналов, в которые Phergie присоединится после успешного подключения к IRC серверу.

phergie_command_prefix: ''

Если вы хотите, чтобы Phergie отвечал только на команды с префиксом (например, !karma [ключевое слово] вместо karma [ключевое слово]), установите префикс здесь.

phergie_ui_enabled: 'true'

Следует ли выводить события бота Phergie в консоли во время его работы (полезно для отладки или проверки активности бота в журналах).

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

Список плагинов Phergie для загрузки. Полный список доступен здесь: https://github.com/phergie/phergie/tree/master/Phergie/Plugin.

phergie_altnicks: []

Список альтернативных никнеймов, которые Phergie будет использовать, если основной ник зайнят (требуется AltNick в phergie_plugins).

phergie_wunderground_api_key: ''

Ключ API Weather Underground для использования (требуется Wunderground в phergie_plugins).

phergie_karma_db_location: ''

Путь к базе данных SQLite, которую Phergie будет использовать, если Karma находится в phergie_plugins. Полезно использовать базу данных вне папки установки Phergie, чтобы она не была стерта при обновлении Phergie через git pull.

Зависимости

• geerlingguy.git

Пример плейбука

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

Внутри vars/main.yml:

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

Лицензия

MIT / BSD

Информация об авторе

Эта роль была создана в 2014 году Джеффом Гирлингом, автором Ansible для DevOps.