Плагин синхронизации задач для redmine

Продолжаем допиливать redmine под свои нужды.
В разное время для нескольких крупных (и не только) клиентов по их желанию были установлены отдельные инстансы redmine.
В основном, они используются для личных нужд клиента: управление репозиториями кода, внутренние задачи.
Но так же в этих трекерах ставились задачи и для системных администратором, то есть для нас.
Проекты росли в своем объеме и количестве, и наступил критический момент, когда сложно стало следить сразу за несколькими трекерами. В то же время, клиенту удобно пользоваться своим трекером, а идти в наш чтобы поставить задачу по администрированию лениво, да и попросту трата лишнего времени.

Ввиду такой ситуации, решили написать силами нашего ruby разработчика kanfet плагин для redmine который бы собирал задачи из всех трекеров в наш.
Под катом описана установка и работа плагина.

Установка и настройка плагина

Установка типовая.
Клонируем плагин с github:

gir clone https://github.com/olemskoi/redmine_synchrony.git /opt/redmine/plugins/redmine_synchrony 

и запускаем миграцию:

bundle exec rake redmine:plugins:migrate RAILS_ENV="production" 

Перезапускаем redmine.

Далее, проводим настройку: идем по следующим пунктам меню — «Администрирование» — «Модули».
Там видим наш плагин в списке:

Выбираем «Параметры».

Жмем

Получаем список полей для заполнения:

Что есть что:

• Адрес сайта для синхронизации — url удаленного remine, из которого нужно вытаскивать информацию
• Ключ API — api key пользователя, под которым будет происходить авторизация из нашего redmine на удаленный. У пользователя должены бять права хотя бы на чтение проекта.
• Трекер для синхронизации — название трекера на удаленном redmine. Из этого теркера будет забираться информация о задачах. Чтобы задачи синхронизировались, их нужно ставить именно в этом трекере на удаленном redmine.
• Локальный проект для задач — имя проекта в нашем redmine. В него будут создаваться/обновляться задачи из удаленного трекера.
• Локальный трекер для задач — имя локального трекера.
• Язык для создания комментариев — язык комментариев.

После заполнения полей изменения сохраняем.

Добавить можно сколько угодно трекеров.
Есть следующие ограничения:

• ID проектов в локальном redmine не должны пересекаться. То есть, синхронизировать в один локальный проект можно только один удаленный.
• Работает схема для версий redmine от 2.2.х и выше.

Для работы нам потребуется задача в cron, которая будет инициировать обновление.
В нашем конкретном случае, задача имет такой вот вид:

*/05 * * * * redmine cd /opt/redmine && PATH=/usr/local/bin:$PATH /usr/bin/bundle exec rake -f /opt/redmine/Rakefile redmine_synchrony:issues RAILS_ENV="production" >/dev/null 2>&1 

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

Принцип работы

Работает плагин по следующей схеме: по cron-таску запускается синхронизация.
Наш локальный redmine проходит по API на удаленный и смотрит изменения задач в трекере, указанном в поле настроек «Трекер для синхронизации».
Изменения отслеживаются за последние сутки.
В случае создания новой задачи в удаленном redmine, она создается и в локальном с полным текстом задачи и со ссылкой на оригинальную.
При обновлении задачи на удаленном redmine на локальном создается комментарий в соответствующей задаче. В тексте комментария указывается смена статуса задачи, пользователь, обновивший ее, приоритет, если он был изменен и сам текст комментария в оригинальной задаче.

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

У меня на этом все.
Буду рад советам и пожеланиям.
На основе их будем делать необходимые доработки.
Спасибо за внимание!