Hosted Project Email2Trac - SOP
Contact Information
Owner: Fedora Infrastructure Team
Contact: #fedora-admin
Location: <not sure what to put here>
Servers: puppet1 / hosted1
Purpose: Provides an email gateway to Trac tickets for hosted projects.
Description
Fedora Hosted Projects can accept email and translate them into Trac tickets for specific projects. This SOP covers how to enable this service for a project.
Editing Config files for Puppet
There are two config files in puppet that control email2trac functionality
web/applications/email2trac.aliases
This is a simple postflix aliases file that lists aliases for each project that would like to receive tickets via email. The standard is to use the project's name as the email address.
pungi: |"/usr/bin/email2trac --project=pungi" rel-eng: |"/usr/bin/email2trac --project=rel-eng"
Simply add a new line for the project that wishes to receive tickets via email.
web/applications/email2trac.conf
This config file is used by the email2trac python script to determine options for handling the mail and which path to use for a given project space.
[DEFAULT] project: /srv/web/trac/projects debug: 0 umask: 022 spam_level: 5 reply_all : 1 mailto_link: 0 umask: 022 email_header: 0 trac_version: 0.10 enable_syslog : 1 alternate_notify_template : drop_spam : 1 verbatim_format: 1 strip_signature: 0 email_quote: > strip_quotes: 0 ignore_trac_user_settings: 0 strip_signature : 1 ticket_update: 1 [pungi] project: /srv/web/trac/projects/pungi [rel-eng] project: /srv/web/trac/projects/rel-eng
Again simply add a section named after the project and provide the path on the filesystem to the trac space.
Installing config files
Install the updated config files via puppet and once the puppet changes have taken effect on hosted1 the new aliase will be ready.
Trac Project Changes
Anonymous Ticket Filing
The Trac project that wishes to receive tickets via email will have to allow anonymous ticket creation and modification. This can be achieved via the Trac webadmin interface: https://fedorahosted.org/<project>/admin/general/perm
anonymous must have access to:
- TICKET_CREATE
- TICKET_MODIFY
Ticket Notifications
In order for the person filing a ticket via email to get a conformation email regarding the ticket, the Trac project should have notifications configured as such. The configuration can be done via the Trac webadmin interface: https://fedorahosted.org/<project>/admin/tracini/notification
- always_notify_owner: true
- always_notify_reporter: true