|
|
| (4 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| = Hosted Project Email2Trac - SOP =
| | This SOP is obsolete. |
| | |
| == 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.
| |
| | |
| <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
| |
