Email gateway for fedorahosted tickets

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