1.0Чудо{вищные} заметкиhttps://miracle.rpz.nameMiRacLehttps://miracle.rpz.name/author/miracle/Просматривая статистику посещений, обратил внимание на то, что многих интересует словосочетание «redmine jabber». Пришла пора удовлетворить спрос. В начале «как обычно» небольшая предыстория о том, «как всё начиналось»:</p> <blockquote> Несколько лет назад мне удалось внедрить <a href="http://redmine.org/">redmine</a> на «производстве», коллеги потихоньку втягиваясь в процесс, затребовали «книгу отзывов и предложений». Одним из первых пожеланий была замена <span title="политика настройки которых мягко говоря идиотская">стандартных уведомлений по email</span> на, успевшие уже войти в моду, <a href="http://miracle.rpz.name/2009/02/24/commit-jabber-php/">jabber-уведомления, которые мы используем для нотификации о новых коммитах в svn</a>. Я вооружился тем самым поисковым запросом, о котором упомянул и немедленно нашёл нужной функциональности <a href="https://github.com/mszczytowski/redmine_messenger/tree" title="Messenger plugin for Redmine">готовый плагин</a>. Помимо уведомлений, автор обещал нам некие таймеры, которые можно стартовать/останавливать посредством команд боту в чате, тем самым «точно» подсчитывать затраченное на решение задачи время. В теории это казалось очень нужной и удобной игрушкой, на деле же оказалось, что плагин был выпилен для старой версии redmine и с trunk-версией работать по полной программе отказался. Худо-бедно он иногда стартовал какие-то таймеры, иногда присылал какие-то уведомления, от полученных команд иногда впадал в ступор и потом долго игнорировал собеседника, в общем вёл себя непозволительно загадочно и непростительно таинственно, но скиллов для исправления обнаруженных проблем мне не хватало, а автор на открытые тикеты особо не реагировал. Мыши плакали, кололись и продолжали есть кактус до одного смешного стечения обстоятельств: я находился в другом городе, бессовестно тратил отпускное время на прогулки, осмотры достопримечательностей и дивных пейзажей, внезапно получил входящий звонок от коллег. Слёзно просили выручать - что-то мол случилось, трах-бах-тарарах ...и всё, нет у нас больше redmine. Немного порассуждав вслух, источник проблемы вроде бы вычислили, каким-то временным образом проблему по телефону решили, но в тот же вечер, добравшись до интернета, плагин я без сожалений выкинул. Случилось следующее — при старте redmine, плагин коннектился к jabber-серверу, а уж затем поднимался сам редмайн, но в тот роковой момент соединение с интернетом пропало, от чего случился обширный exception и redmine умер не приходя в сознание. </blockquote> <div align="center">***</div> <p> Тогда стало понятно, что схема со злобным плагином не работает и уведомления надо рассылать внешним по отношению к redmine решением (здесь знатоки rails могли бы долго возражать, но уже поздно). Параллельно с этой проблемой существовали другие.<!--more--> <a href="http://miracle.rpz.name/2009/02/24/commit-jabber-php/">Cкрипт, о котором уже упомянул выше</a>, работал прямо скажем неэффективно. Во-первых он <span title="казалось бы - какая разница?! часто что ли коммиты бывают? нет, но всё равно раздражает!">соединялся с xmpp-сервером после каждого коммита</span>, порой делал это долго, порой это у него не получалось, порой сообщения не доставлялись адресату, даже если соединение с сервером было успешным. Поэтому рассылку уведомлений сразу после коммита пришлось разбить на два шага: 1) положить в очередь сообщения для адресатов 2) забрать уведомление из очереди и разослать, после подтверждения доставки удалить его из очереди. Теперь второй скрипт запускался периодически (не после коммита) рассылал уведомления, удалял их из очереди (подтверждения о получении я реализовать не смог). По-прежнему оставалась проблема с пропадающими сообщениями. Немного покопавшись в недрах протокола я обнаружил что клиент получателя, сервер получателя или мой xmpp-сервер при возникновении ошибки возвращают моё сообщение но с типом <em>error</em>: это значило, что периодический запуск «рассылатора-уведомлятора» не подходит — надо держать постоянное соединение с сервером и должным образом обрабатывать входящие сообщения. Так «в муках» родился прототип <a href="http://miracle.rpz.name/2009/12/05/jabber-web-status/">бота webstatus-а</a>, а с ним и рабочая реализация механизма уведомлений по xmpp. Первоначально это был скрипт на php, который при запуске подключался к jabber-серверу, периодически дёргал mysql запросом на получение новых сообщений и рассылал их, помечал как отправленные, если потом возвращались ошибки - вновь отмечал сообщения как непрочитанные. В mysql-таблицу сообщения попадали от разных источников - от post-commit хука в svn, от различных скриптов, которые запускаются cron-ом и собирают необходимые нам данные. <div align="center">***</div> <p> Таким образом прикрутить это решение к redmine стало просто делом техники — требовалось лишь сделать «триггеры» в нужных моделях, которые бы добавляли новые записи в таблицу с очередью сообщений для xmpp-бота. Уже позднее <a href="http://miracle.rpz.name/2010/11/20/jabber-web-status-2/">php-решение было переписано на модной нынче node-платформе</a>. Потребовалась лишь прослойка в виде <a href="http://code.nytimes.com/projects/dbslayer">dbslayer</a> для того чтобы соединить node и mysql. <p> Теперь всё выглядит следующим образом: <ul> <li>Сообщения от разных источников попадают в mysql (например :after_save в issue модели редмайна, post-commit хук в svn и т.д.) <li>Jabber-бот (на <a href="http://nodejs.org">node</a>) периодически делает запрос в mysql (через <a href="http://code.nytimes.com/projects/dbslayer">dbslayer</a>) вида <code>select msg, recipient from msg where recipient in (cписок тех, кто сейчас в онлайне)</code>, если получен непустой результат, то сообщения отправляет адресату и отмечает их прочитанными. <li> Если сообщение вернулось с ошибкой - бот отмечает его непрочитанным, а адресата на некоторое время отправляет «на скамейку запасных» (чтобы не долбить его повторяющимися запросами) <li> Бот поддерживается на плаву с помощью <a href="http://supervisord.org/">supervisord</a> (случаются ошибки, как правило сетевые, которые не удаётся поймать стандартными try-catch в коде бота, после некоторых попыток обработать все возможные проблемы я пришёл к выводу, что проще «упасть и товарищи поднимут» нежели пытаться «любой ценой устоять» — всё-таки данные не настолько критичные и безвозратная потеря сообщения терпима. </ul> <div align="center">***</div> <p id="download"> Тех, кто дочитал до этого места и всё ещё жаждет получить ссылку <a href="#download">«скачать»</a> мне придётся огорчить — описанный код сильно заточен под наши конкретные нужды и планов его публикации не было, поэтому redmine-зависимая часть кода просто на-тяп-ляплена посреди моделей самого редмайна безо всякой попытки вынести эти части в отдельный плагин, node-часть тоже не обошлась без влезания в «чужие» библиотеки. А это всё значит лишь одно: plug-n-play решения у меня нет. Но <a href="http://miracle.rpz.name/2011/06/27/redmine-with-jabber-notifications/#dsq-comments">в комментариях</a> вы можете попробовать наладить конструктивный диалог и мы совместными усилиями создадим работающий у вас плагин, с чаем и шахматистками. Вас это интересует? rich