Skip to content

spyder007/teamcity-msteams-notifier

Repository files navigation

DEPRECATION NOTICE

Professionally and personally, I have moved away from TeamCity as a build server for a variety of reasons. That move means I have no real time to devote to developing this plugin. Couple that with the fact that I am not a Java developer by trade, and it is painfully slow for me to get anything done in this project.

Additionally, TeamCity has grown, and the way this is currently written does not work well. If someone takes this over, it may be more useful to use the Notificator implementation in this plugin MsTeamsNotificator.java as the basis for a new plugin, and then extend the Notification Templates model by implementing a Template Processor. There is far too much code in this plugin that mimics the trigger settings that exist, by default, on notifications today, and it's confusing within the UI.

Feel free to fork this, but should someone want to take over this plugin, I will gladly transfer ownership to you. Thanks!

Teamcity MS Teams Build Notifier

Build Status - Master

Overview

Posts Build Status to MsTeams. This plugin is based on the tcSlackBuildNotifier plugin.

Sample Notification Sample Notification

Tested on TeamCity 2019.1 (build 65998)

Installation

Head over to the releases section and get the zip labelled tcMsTeamsNotifierPlugin.zip from there (do not download the one on this page). Copy the zip file into your TeamCity plugins directory.

You will need to restart the TeamCity service before you can configure the plugin.

Configuration

Once you have installed the plugin and restarted head on over to the Admin page and configure your MsTeams settings.

Admin Page Configuration

  • To configure an incoming webhook for a channel, go to the Connectors section for the channel and configure an Incoming Webhook connector. Then, copy the resulting URL and paste it into the Webhook URL field. You will need a different Webhook URL for each channel.

Usage

From the MsTeams tab on the Project or Build Configuration page, add a new MsTeams Notification, and you're away!

Sample Build Configuration

Contribution

In order to contribute to the project you first need to check out the project sources. This project uses the TeamCity Plugin SDK for development.

In order to test the plugin simply run the following command with java and mvn installed:

mvn package tc-sdk:start

By default, it will install TeamCity in the version listed in the property in the root pom.xml. However, you can overwrite this setting by using the -DteamcityVersion=10.0 switch.

Other available commands can be found here.