jochenvangasse / tfsnotificationrelay

An extensible plugin for TFS 2013/2015 that sends notifications to Slack, HipChat and IRC

TfsNotificationRelay

TfsNotificationRelay is an extensible plugin for Team Foundation Server that sends notifications to Slack, HipChat and IRC.

Features

• Notify multiple targets
• Rule-based event filtering
• Collection/project/repository regex filtering
• Configurable notification format
• Notification links to event in TFS web
• Extensible

Events

• XAML Build completion
• vNext Build completion (*)
• Build quality change
• Work item update
• Team project creation/deletion
• Git
  • Push
  • Comment on commit (*)
  • Pull request (*)
  • Comment on pull request (*)
  • New repository
  • New branch/tag
  • Deleted branch/tag
  • Updated ref
  • Lightweight/annotated tag
  • Force-push
• TFVC
  • Checkin
  • Comment on changeset (*)

*TFS 2015 only

Screenshots

Installation & Configuration

See the wiki.

TFS version support

There are two separate releases of TfsNotificationRelay:

• TfsNotificationRelay for TFS 2013 - Should work on TFS 2013.2 and up. Because of a few breaking API changes in TFS 2013.2, the plugin won't work on previous versions without some minor modifications.
• TfsNotificationRelay for TFS 2015

Branches

Branch	Description
master	TfsNotificationRelay for TFS 2013
tfs2015	TfsNotificationRelay for TFS 2015
develop	Current development (based on master)

Extending TfsNotificationRelay

TfsNotificationRelay can easily be extended to send notifications to other services. Notifier modules referenced in the configuration file will be loaded dynamically at run time, so TfsNotificationRelay doesn't have to be recompiled.

1. Start a new class library project.
2. Add a reference to DevCore.TfsNotificationRelay.dll.
3. Create a class that implements the single method in INotifier. Take a look at the SlackNotifier class for pointers.
4. Build and drop in your new dll in the Plugins directory on the server.
5. Add a new bot element in DevCore.TfsNotificationRelay.dll.config with the correct assembly-qualified type name and settings.

License

Copyright (C) 2014-2015 Kristian Adrup

TfsNotificationRelay is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See included file COPYING for details.