Posts build notifications to Slack
Java JavaScript CSS
Clone or download
marvin-w Merge pull request #156 from A4Vision/master
Refactor SlackNotificationPayloadContent - extract delegate class
Latest commit cebcc50 May 22, 2018

README.md

tcSlackBuildNotifier

Join the chat at https://gitter.im/PeteGoo/tcSlackBuildNotifier

Overview

Posts Build Status to Slack

Sample Notification Sample Notification

Tested on TeamCity 8.1.2 (build 29993), 9.1 (build 36973)

Installation

Head over to the releases section and get the zip labelled tcSlackNotifierPlugin.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 Slack settings.

Admin Page Configuration

  • your default channel is the channel with the # in front of it e.g. #general.
  • your team name is the team e.g. mycoolteam NOT mycoolteam.slack.com.
  • The user token is available when you got to https://api.slack.com/web while logged in to your Slack instance. Under "authentication" you should see a token displayed like below. Alternatively you can use the full URL from the Incoming Webhooks integration in the API token field. The webhooks integration approach is sometimes more preferable as the token is not tied to a user account.

Sample Auth Token

Usage

From the Slack tab on the project or build page (not the Build Configuration Settings page), add a new Slack Notification and you're away!

Sample Build Configuration

  • Remember to put the # in front of the channel name if applicable.

Mentions

In order to receive mentions and direct messages from the notifier you must go to your profile page in TeamCity and tell it your Slack username (no need to include the @). Once you have done this you can be mentioned on failed builds. You can also subscribe to notifications on your profile page.

Contribution

In order to contribute to the project you first need to checkout 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.