beehive

Улей

PeeHive - это система событий и агентов, которая позволяет создавать собственные агенты, которые выполняют автоматизированные задачи, вызванные событиями и фильтрами. Это модульный, гибкий и очень легко расширять для всех. У него есть модули (мы называем их ульями ), поэтому он может взаимодействовать, общаться или получать информацию из Twitter, Tumblr, Email, IRC, Jabber, RSS, Jenkins, Hue - и назвать лишь немногие. Проверьте полный список доступных ульев в нашей вики.

Соединение этих модулей друг с другом позволяет создавать чрезвычайно полезные агенты.

Вот лишь несколько примеров вещей, которые улей может сделать для вас:

• Re-post твиты в вашем блоге Tumblr
• Переслать входящие сообщения чата в свою учетную запись электронной почты
• Включите систему нагревания, если температура падает ниже определенного значения
• Запустите свой собственный IRC Bot, который позволяет запустить сборку на Jenkins CI
• Управляйте системой освещения оттенка
• Уведомить вас, когда цена акции снижается ниже определенной стоимости

Установка

Пакеты и двоичные файлы

• Arch Linux: Улей (AUR)
• Linux Static 64Bit
• Linux Static Armv6
• MacOS 64 -бит
• Windows 64 -бит

Вы можете найти еще более официальные релизы здесь.

Инструменты развертывания

• Docker: docker run --name beehive -d -p 8181:8181 fribbledom/beehive
• Ansible

Из источника

Улей требует 1,13 или выше. Убедитесь, что у вас есть среда для работы. Смотрите инструкции по установке.

Рекомендуемый способ состоит в том, чтобы принести источники и запустить.

 git clone --recursive https://github.com/muesli/beehive.git
cd beehive
make

Вы можете построить и установить двоичный файл beehive , как и другие двоичные файлы Go ( go get ), но вам нужно убедиться, что у PeeHive может найти активы (изображения, JavaScript, CSS и т. Д.). См. Раздел «Устранение неполадок»/«Примечания» для получения дополнительной информации.

Запустите beehive --help чтобы увидеть полный список вариантов.

Конфигурация

Думайте о ульеях как о небольших плагинах, расширяя способности у Pealhive с помощью событий, на которые вы можете реагировать, и действия, которые вы можете выполнить.

Как и в качестве примеров, есть плагин в Твиттере, который может

• отреагируйте на кого -то, кого вы следуете, опубликовав твит (событие)
• Разместите для вас новый твит (действие)
• ...

или плагин RSS, который позволяет вам

• Мониторинг RSS -каналов и реагируйте на новые элементы подачи (другое событие)

или плагин по электронной почте, который дает вам возможность

• Отправить электронные письма (другое действие)

Каждый улей позволяет вам породить одну или несколько пчел, все работающие независимо от другого. Это позволяет вам создавать отдельные экземпляры плагина, например, один электронный по электронной почте для вашей частной почтовой учетной записи, а другой для вашего рабочего письма.

Создание пчел

Звучит сложно? Это не! Просто для развлечения, давайте настроем уход, чтобы отправить нам электронное письмо, когда обновляется канал RSS. Начните beehive и откройте http: // localhost: 8181/в вашем браузере. Обратите внимание, что PeeHive создаст файл конфигурации beehive.conf в своем текущем рабочем каталоге, если только вы не указате другой файл с опцией -config .

Примечание. Если вы построили уход с go build вместо того, чтобы make вам, что вам придется запустить beehive из своего исходного каталога, чтобы он мог найти все ресурсы для интерфейса администратора. Также см. Раздел «Устранение неполадок» и «Примечания» этого Readme.

Интерфейс администратора представит вам список доступных ульев. Нам нужно будет создать здесь двух пчел, одну для RSS -канала и одну для вашей учетной записи электронной почты.

Настройка цепочки

Теперь нам придется создать новую цепь, которая подключит двух пчел, которые мы только что создали. Сначала мы выбираем пчелиное событие, на которое мы хотим отреагировать, затем мы выбираем пчелу, с которой мы хотим выполнить действие. Событие RSS-Bee дает нам целый набор параметров, с которыми мы можем работать: название элемента подачи, его ссылки и описание среди других. Вы можете манипулировать и комбинировать эти параметры с полным языком шаблона в вашем распоряжении. Например, мы можем установить контент электронной почты на что -то вроде:

 Title: {{.title}} - Link: {{index .links 0}}

Всякий раз, когда это действие выполняется, PeeHive заменяет {{.title}} на параметр title события RSS, который является названием полученного элемента подачи. Таким же образом {{index .links 0}} становится первым URL -адресом массива links этого события.

Вот и все. Всякий раз, когда RSS-Feed обновляется, PeeHive теперь отправит вам электронное письмо! Действительно легко заставить различные пчелы работать беспрепятственно и делать для вас умные вещи. Попробуйте сами!

Вы можете найти больше информации о том, как настроить уход и примеры в нашей вики.

Устранение неполадок и заметки

Веб -интерфейс и другие ресурсы по умолчанию встроены в бинарную. При использовании make noembed Fehive пытается найти эти файлы в своем текущем рабочем каталоге, поэтому в настоящее время рекомендуется запустить Pealhive из своего репозитория GIT, если вы планируете использовать веб -интерфейс.

Если вы все еще не сможете достичь веб -интерфейса, проверьте, пуст ли каталог config в репозитории GIT. Если это так, убедитесь, что подмодулы GIT инициализируются, запустив git submodule update --init .

Веб -интерфейс еще не требует аутентификации. У PCEEHIVE по умолчанию принимает все подключения только от устройства Loopback.

Если вы хотите связать уход с другим интерфейсом/адресом, запустите уход с параметрами -bind и -canonicalurl . Например:

 beehive -bind "192.168.0.1:8181" -canonicalurl "http://192.168.0.1:8181"

или

 docker run --name beehive -d -e CANONICAL_URL="http://192.168.0.1:8181" -p 8181:8181 fribbledom/beehive

Разработка

Нужна помощь? Хотите взломать свои ульи? Присоединяйтесь к нам на IRC (IRC: //freenode.net/#beehive) или друттер. Следите за пчелами в Твиттере!