From Fedora Project Wiki

m (1 revision(s))
(Drop SOP since email2trac has been disabled.)
Line 14: Line 14:
== Description ==
== 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.
email2trac has been disabled due to inability to control spamAlternatives have been explored such as a command line tool to work with Trac in an authenticated way.
 
== 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 emailThe standard is to use the project's name as the email address.
 
<pre>
pungi: |"/usr/bin/email2trac --project=pungi"
rel-eng: |"/usr/bin/email2trac --project=rel-eng"
</pre>
 
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.
 
<pre>
[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
</pre>
 
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: <code> https://fedorahosted.org/<project>/admin/general/perm </code>
 
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: <code> https://fedorahosted.org/<project>/admin/tracini/notification </code>
 
* always_notify_owner: true
* always_notify_reporter: true

Revision as of 23:21, 16 December 2008

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

email2trac has been disabled due to inability to control spam. Alternatives have been explored such as a command line tool to work with Trac in an authenticated way.