Как настроить почту в redmine
Как настроить электронную почту в Redmine
Сегодня мы с вами поговорим о том, как настроить электронную почту в программе Redmine.
Настройка параметров электронной почты в Redmine версии 2.1.2 осуществляется в «INSTALLDIR / Apps / Redmine / Config / configuration.yml».
Обратите внимание, что в старых версиях (до 2.х.х) вы должны использовать » INSTALLDIR / Apps / Redmine / Config / email.yml «файл.
Простая Аутентификация (настройки по умолчанию)
Пример конфигурации для GMail аккаунта
После того, как email.yml файл изменен, необходимо перезапустить процесс Apache:
В Redmine 2,0 или выше, если вы видите подобную ошибку типа: » An error occurred while sending mail (SSL_connect returned=1 errno=0 state=SSLv2/v3 read server hello A: unknown protocol) «, необходимо удалить «tls: true» из файла configuration.yml. Тогда, в этом случае, вы только должны перезагрузить Apache:
Если вы используете сервер SMTP, которые не требуют проверки подлинности, вполне возможно, что вы должны добавить следующие опции:
Вы также можете найти более подробную информацию на Redmine wiki page и Redmine blog.
P.P.S. Если в настройке учётной записи «Уведомления по email» выбрано (по умолчанию): «Только о тех событиях, которые я отслеживаю или в которых я участвую», то вам будут отсылаться только уведомления по задачам которые или назначены Вам, или в которых вы выбраны Наблюдателем. Сообщения с форумов и новости Вы получать не будете, даже если участвуете в проекте.
Поэтому, чтобы для проектов в которых вы участвуете, получать уведомления на:
нужно в «Уведомления по email» выбрать вариант «О всех событиях во всех моих проектах».
Ещё один блог сисадмина
воскресенье, 5 октября 2014 г.
Настройка почты в Redmine, обновление структуры базы данных
Для отправки уведомлений об изменении в задачах заинтересованным лицам, в каталоге с настройками Redmine можно создать файл /etc/redmine/default/configuration.yml следующего вида:
Смысл настроек понятен из их названия. Существует ещё возможность отправлять почту при помощи локальной команды sendmail. Подробнее о настройках отправки почты можно почитать здесь: Настройка почты
Во вкладке «Общие» поправить поле «Имя компьютера», указав веб-адрес, по которому доступен Redmine, но без протокола и без косых черт слева и справа:
Во вкладке «Уведомления по email» нужно выбрать события, уведомления о которых нужно отсылать, указать адрес, с которого будут отправляться письма:
Там же можно указать заголовок письма и текст, который будет добавлен ниже тела письма (обычно там пишут про то, что на сообщение не нужно отвечать, что оно сгенерировано автоматически, почему оно пришло адресату или как отписаться от писем).
Адреса пользователей можно редактировать в их профилях.
2. Обновление структуры базы данных
Если у вас имеется база данных от старой версии Redmine, которую вы хотите развернуть на более свежей версии Redmine, то обновить структуру базы данных до более свежей версии очень просто:
В Debian существует возможность легко запустить на одном компьютере несколько разных экземпляров Redmine. В переменной X_DEBIAN_SITEID можно указать имя экземпляра Redmine. Имя экземпляра задаёт имя подкаталога в каталоге /etc/redmine/. В подкаталоге экземпляра находятся файлы с настройками Redmine. Если имя экземпляра не указывать, то подразумевается экземпляр default и используются настройки из каталога /etc/redmine/default/.
В Debian даже есть возможность управлять созданием и удалением экземпляров Redmine при помощи мастера, которого можно запустить по команде dpkg-reconfigure redmine. Но я предостерегаю им пользоваться, т.к. при создании нового экземпляра он удаляет настройки уже существующего, не обращая внимания на ваш ответ о том, что вы не хотите это делать.
Как настроить почту в redmine
redmine настройка почты через smtp
Модераторы: Art.i, vasya
redmine настройка почты через smtp
Какие в redmine прописать настройки, что отправлялась почта?
Прописываю в configuration.yml
production:
email_delivery:
delivery_method: :smtp
smtp_settings:
address: smtp.my.ru
port: 25
domain: my.ru
authentication: :login
user_name: «info@my.ru»
password: «pass»
Re: redmine настройка почты через smtp
Re: redmine настройка почты через smtp
я не могу сказать какая ошибка у предыдущего пользователя, но я уже всю голову разбил о клавиатуру. В данный момент стоит следующая конфигурация:
Код: выделить все Environment:
Redmine version 2.3.0.stable
Ruby version 1.8.7 (amd64-freebsd9)
Rails version 3.2.13
Environment production
Database adapter Mysql2
Redmine plugins:
no plugin installed
FreeBSD 9.0
сначала, в конфигурации прописал вот это:
Код: выделить все default: # Outgoing emails configuration (see examples above)
email_delivery:
delivery_method: :smtp
smtp_settings:
address: mail.my_host.su
port: 587
domain: mail.my_host.su
authentication: :login
user_name: «user@my_host.su»
password: «my_pass»
и при попытке отправить тестовое сообщение, получил вот это:
Код: выделить все (hostname was not match with the server certificate)
Покопавшись до середины ночи в инете, ПЕРЕЧИТАЛ до дыр вот эту тему (и даже запостился там, но ответа пока нет):
Код: выделить все http://www.redmine.org/boards/2/topics/30851
в итоге пробовал по разному:
Код: выделить все и так:
openssl_verify_mode: 0
и вот так:
openssl_verify_mode: ‘none’
Результат-ноль!: либо вываливается вот такая ошибка:
Код: выделить все (wrong argument (Fixnum)! (Expected kind of OpenSSL::SSL::SSLContext))
либо вообще отваливается Ruby и рельсы с ним, приложение не поднимается.
Сегодня, плюнул на все, зарегил почту на Яндексе БЕЗ ССЛ и все заработало как часики. Но блин, хочется-то на своем серваке все это иметь, вот и вопрос:
как пофиксить это все?
-Или, как отключить проверку ССЛ для конкретного домена (локалхоста) или для конкретного ящика?
И вопрос не в тему: как перезапускать отдельное приложение Ruby. В данный момент перезапускаю Апач.
Заранее ОГРОМНОЕ СПАСИБО за ответы!
Re: redmine настройка почты через smtp
Re: redmine настройка почты через smtp
Спасибо за подсказку. Вопроса два:
1. Где и чем просмотреть сертификат? (пользуюсь ВДС-Улет). И в каком виде он там будет написан.
2. Как отключить ТЛС. я с Руби столкнулся впервые.
Re: redmine настройка почты через smtp
Re: redmine настройка почты через smtp
Здравствуйте, ls,
— Извиняюсь за долгий ответ. был в командировке без РС =)
вот образ диска FreeBSD-9-ISPmanager
почтовый сервер по умолчанию. Я ничего не перенастраивал.
Re: redmine настройка почты через smtp
Та же самая проблема и меня.
Уже 2 клавиатуры разбил. Но очень хочется всё-таки подключить почту.
У меня доп. вопрос: прежде чем мучиться с настройкой почты редмайна, нужно ли создавать почтовый домен и нужно ли заводить почтовый ящик?
Re: redmine настройка почты через smtp
Re: redmine настройка почты через smtp
Redmine
Latest releases¶
Resources¶
Receiving emails¶
Redmine can be configured to allow issue creation or comments via email. It is also able to recognize and incorporate email replies to forum messages.
Setup¶
You can configure Redmine to receive emails in one of the following ways:
Forwarding emails from your email server¶
Copy rdm-mailhandler.rb to your mail server, make sure its permissions allow execution ( chmod +x rdm-mailhandler.rb ), and configure your MTA (Mail Transport Agent).
Here is an example for a Postfix local alias entry:
If your domain is setup as a virtual mailbox map (so that you use /etc/postfix/virtual_mailbox_maps to do mappings in the form user@example.com /path/example.com/user ) you should:
Fetching emails from an IMAP server¶
For Windows as server pycron can be used to schedule a fetch task.
It can be necessary that you open the firewall on the machine for outgoing TCP connections to IMAP port 143.
Available IMAP options:
User and permissions options:
Issue attributes control options:
See Issue-attributes for a list of values that can be used for the allow-override option.
Examples for the rake command:
Ignored emails are marked as ‘Seen’ but are not deleted from the IMAP server—these include unknown user, unknown project and emails from the redmine emission account.
The option allow_override is not only for overriding default values given to rake, but for every attribute in a mail. If you want to override the tracker in your mail you have to add allow_override=tracker as a parameter.
Fetching emails from a POP3 server¶
A rake task ( redmine:email:receive_pop3 ) can be used to fetch incoming emails from a POP3 server.
Available POP3 options:
See the IMAP rake task above for issue attributes control options.
Reading emails from standard input¶
A rake task ( redmine:email:read ) can be used to read a single raw email from the standard input.
See the IMAP rake task above for issue attributes control options.
The option allow_override is not only for overriding default values given to rake, but for every attribute in a mail. If you want to override the tracker in your mail you have to add allow_override=tracker as a parameter.
Enabling unknown users to create issues by email¶
Redmine has a feature that provides the ability to accept incoming emails from unknown users. In order to use this feature, an extra parameter has to be included:
Permissions have to be consistent with the chosen option. E.g. if you choose ‘create’, the ‘Non member’ role must have the ‘Add issues’ permission so that an issue can be created by an unknown user via email. If you choose ‘accept’, the ‘Anonymous’ role must have this permission.
If you receive emails via the rake task, the unknown-user option has to be written as:
You can disable permission checking using the ‘no_permission_check’ option:
This, together with the ‘unknown-user’, provides the ability to let anyone submit emails to a private project. For example:
will let anyone submit emails to a private project ‘foo’.
TODO: Is this true and is this related to the no_permission_check option?:
Since Redmine 0.9 the project doesn’t have to be public, but authentication required in the Administration-> Settings->Authentication tab has to be unchecked.
If you do not want an «new account notification email» sent to every newly created user by rdm-mailhandler you must add the option «—no-account-notice». Is implemneted with 2.3.0 in issue #11498. Now an example:
Schedule email receiving with Rufus Scheduler¶
Instead of using a cron to trigger the Rake task to retrieve incoming email, you can use Rufus Scheduler which will run the Rake task in the same process as Redmine.
This is using less resources and faster than calling the Rake task from a cron (or from the Task Scheduler on Windows).
To do that, install rufus-scheduler gem:
Create a what_you_want.rb file in /config/initializers/ and put the following content in your file. (Here for a POP3 account. Change it with your own parameters and own task.)
Restart your Redmine instance and your incoming emails will be retrieved on schedule.
You can check Rufus-Scheduler for scheduling syntax.
How it works¶
When receiving an email, Redmine uses the From address of the email to find the corresponding user. Emails received from unknown or locked users are ignored.
If the email subject contains something like «Re: [xxxxxxx #123]» or «[#123]», the email is processed as a reply and a note is added to issue #123. Otherwise, a new issue is created.
Note that, in order to create an issue, all required custom fields must be provided. Without them, issue creation will fail. As an alternative you can ensure that every custom field has a default value which is then used during issue creation.
Target project¶
The target project can be specified using the project option when receiving emails. This should be the identifier of the project and not the name. You can easily find the identifier in the URL.
Example (email body):
You can set a default project using the project option and let users override this default project by using the allow-override option when receiving emails.
Example:
Of course, user permissions are checked and this email would be ignored if the user who sent this email is not allowed to add issues to project foo.
Make sure that the target project doesn’t use required custom fields with no default value for its issues, otherwise the creation of the issue will fail.
Target Project from Email Sub-Address¶
This feature was introduced in ver 3.2.0 (SVN rev r14687). It may be preferable to have one mailbox for all incoming emails to a Redmine instance, instead of one per project. When receiving emails at redmine@somenet.foo, an email sent to redmine+foo@somenet.foo will cause the issue to be added to project with identifier foo.
To enable this feature add the project_from_subaddress=redmine@somenet.foo to the command e.g.
emails to redmine@somenet.foo or redmine+bar@somenet.foo will raise issues in project bar; emails to redmine+foo@somenet.foo will go into project foo.
Issue attributes¶
Based on the options you use when receiving emails (see allow-override option), users may be able to override some attributes when submitting an issue.
Note: prior to Redmine 3.2.0 (#20543) some attributes were always overridable, but this was not documented. This behavior has been changed and all attributes have to be explicitly listed with the allow_override option to be overridable. For those who want all attributes to be overridable, allow_override=all can now be used (#20543).
Once allow_override has been configured, you can override those attributes by using the appropriate keywords in the email body.
Example keyword list:
The values available are the ones of the context. E.g. Status available (for this Tracker and this Project) are labels in the localized language, exactly as displayed in the user interface or system default language (even with spaces, without quoting).
Example (email body):
The format for keywords differs from the allowed attribute values for the allow_override option:
Multiple attribute values can be specified in order to allow only certain keywords to be used.
Watchers¶
If the user who sends the email has the ‘Add issue watchers’ permission, users that are in To or Cc field of the email are automatically added as watchers of the created issue.
Watchers are added only when the issue is created. To or Cc fields are ignored on replies. See #7017 and #8009.
Email format and attachments¶
Redmine tries to use the plain text part of the email to fill the description of the issue.
If a HTML-only email is received, HTML tags are removed from its body.
Email attachments are automatically attached to the issue, unless their size exceeds the maximum attachment size defined in the application settings.
Truncate emails¶
Плагин «Unread issues» — как мы уведомляем сотрудников в Redmine. Общая концепция
Сегодняшняя статья будет про уведомления об изменениях в задачах Redmine. О том, какие средства есть в коробочном Redmine и о том, что мы доработали сами.
Любой task-трекер имеет средства уведомления об изменениях в задачах, и Redmine — не исключение.
Электронная почта
Коробочный Redmine может уведомлять пользователей об изменениях в задачах по электронной почте. Довольно стандартная функциональность, но опций по ее кастомизации не очень много.
Достаточно просто расширять опции, но, как нам показалось, уведомление посредством письма — не самый лучший вариант сообщить о том, что в задаче что-то изменилось. Со временем, ты просто перестаешь обращать какое-либо внимание на все письма, валящиеся к тебе в ящик, ассоциируя их со спамом.
Кстати, у уведомлений по электронной почте в Redmine есть еще один фатальный недостаток. Redmine не отдает страничку с задачей пока не отправит письмо на сервер и, если с почтовым сервером происходит что-то плохое, то страничка с задачей не отдается пользователю достаточно долго (до 15 секунд).
Автор статьи потратил не мало времени, анализируя проблему долгого открытия странички с задачами, и как оказалось администраторы сети поменяли настройки почтового сервера.
Почти на все списки задач, комментарии к задачам и т.д. можно завести RSS –feed и использовать его в RSS-ридерах мобильных телефонов, например. Достаточно удобный способ, которым даже IT-ки пользуются редко.
Моя страничка
Стандартная «Моя страница» позволяет вывести лимитированный, преднастроенный и вшитый в код программного продукта, набор блоков. Преднастроенного набора блоков практически сразу начинает не хватать. Помимо прочего, есть еще одна глобальная проблема со списком задач, которые отображаются в блоке на моей страницы – нет никакого уведомления о том, что меняется внутри задачи.
Что сделали мы, чтобы оперативно информировать пользователей об изменениях в задачах.
Кружочки-индикаторы
Мы придумали и реализовали синие, светло-зеленые и темно-зеленые кружочки. Что они означают!?
Кружочки моментально прижились в компании и стали ненавязчивым и в тоже время информативным средством уведомления пользователей об изменениях в задачах.
Мы оформили эту функциональность в виде отдельного плагина — «Unread issues», и с радостью делимся им с сообществом.
Помимо кружочков-индикаторов, которые добавляются во все списки задач, плагин также позволяет определить запрос задач, на основе которого будут считаться индикаторы-счетчики для моей страницы. Это очень удобно, если пользователей, например, не нужно уведомлять об изменениях в определенных трекерах.
Кружочки индикаторы для других сущностей и проблемы с производительностью.
Со временем появился плагин «Ajax counter», который позволяет вычислять и отображать счетчики асинхронно. Это позволяет пользователям получать страницу еще до вычисления всех счетчиков.
Этот же плагин позволяет устанавливать интервал обновления счетчика, чтобы значение для него не пересчитывалось каждый раз при обновлении страницы. Так например, для регламентного действия «Ознакомиться с приказами» можно поставить интервал в 1 час, поскольку новые приказы выходят редко.
Плагин «Ajax counter» находится в свободном доступе тут: bitbucket.org/dkuk/ajax_counters. Думаю, что он может быть полезен программистам, которые разрабатывают под Redmine.
Блок «Что мне нужно сделать?»
Мы используем Redmine как единую корпоративную среду. И в этой среде, сотрудники часто забивают, а иногда и просто бойкотирую обязанность выполнять регламентные процедуры.
Ну, например, есть правило, которое гласит, что сотрудник обязан ознакамливаться с изменениями в задачах, назначенных на него, в течение трех дней. И кто-то не делает этого регулярно, объясняя свои действия неудобством программы и непонятностью интерфейса.
Поэтому, появился замечательный блок на моей странице «Что мне нужно сделать?», в котором популярно расписано, что сотрудник должен сделать сегодня, в ближайшие семь дней, в текущем месяце, а за одно и то, что должны сделать его подчиненные.
Блок «Что мне нужно сделать?» здорово уменьшает входной порог для работы в системе.
Действия для блока могут задаваться в сторонних плагинах. Например, плагин «KPI» задает свой список действий для блока: согласование аванса, закрытие ЗП и т.д.
Также, действия для блока могут задаваться на основе стандартных запросов задач Redmine. Вы можете выбрать какой-то запрос и определить в нем поле с датой, по которому будет считаться срок необходимого выполнения задачи. Этот подход дает большую гибкость, поскольку превращает любой запрос задач в регламентное действие. Например, легко создать регламентные действия вида: «Проверить задачи», «Дать обратную связь по задачам» и т.д.
Кружочки-индикаторы и блок «Что мне нужно делать?» перекрывают потребности сотрудников в информирование об изменениях.
Чуть раньше у нас были уведомления по протоколу XMPP в jabber-клиент, но потребность в них со временем отпала. К тому же, постоянно сыплющиеся сообщения вида «В задаче такой-то произошли изменения», очень быстро достают пользователя.
Надеюсь, статья будет полезна. Пробуйте наш плагин «Unread issues». Любая обратная связь приветствуется!