Skip to content
TeamCity Slack plugin
Scala Java JavaScript CSS
Branch: master
Clone or download
Aleksey Kvak
Aleksey Kvak v1.3.0
Latest commit 26c8b97 Oct 7, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_doc #36 No preview available May 17, 2019
build v1.3.0 Oct 7, 2019
slackIntegration-server Escape unicode characters in config file. Oct 7, 2019
.gitignore .hgignore -> .gitignore Oct 30, 2017
.travis.yml .travis.yml added Oct 30, 2017
LICENSE Create LICENSE Nov 29, 2017
README.md #36 No preview available May 17, 2019
pom.xml #36 No preview available May 17, 2019
teamcity-plugin.xml teamcity-plugin data updated Oct 30, 2017

README.md

TeamCity Slack plugin

Build Status

This plugin allows you to integrate your CI with Slack.

The main feature is that you can specify not exact branch name but the regexp branch mask.

For example, if you have separate build configurations for feature branches and common branches, then it is easy to setup notifications into corresponding Slack channels.

The second big thing is that you can compose your own messages using template placeholders and Slack formatting.

And you can easily send notifications without running the build with the Try it feature.

The plugin automatically backs up its settings after each modification.

Successful build Failed build Artifact links

Table of Contents

  1. Install plugin
  2. Build configuration
  3. Message placeholders
  4. Artifact links
  5. Message preview

Install plugin

Download from releases or compile sources with mvn package.

Next upload target/slackIntegration.zip to TeamCity data/plugins/ folder (restart is needed).

Go to api.slack.com

  • Create new app.
  • Go to Features - Incoming Webhooks and Activate Incoming Webhooks
  • Go to Bot Users - Add Bot User
  • Go to OAuth & Permissions and click Install App in Workspace
  • Now copy Bot User OAuth Access Token.

Paste this token into Administration -> Slack -> OAuth Access Token field.

Plugin setup

That's it! Now you can open any build configuration home and choose Slack tab.

By default personal notifications (private notifications) are disabled. Personal notifications notify only about failed builds.

Slack tab Only admins and projects admins have rights to access these settings.

Build configuration

Sample configuration:

Edit settings

Notifications for branches captured by regular expression will be sent to slack channel or/and private chat. Message will be compiled according to template.

The Only trigger when build changes option allows you to be notified when the previous build status changes from failure to success, or vice versa. The previous build is the latest build on the same branch as the current build (or not if the current build has no branch), and its status is determined (failure or success) and it's not a personal build.

Note. Please avoid using heading # in channel name.

The build settings number is not limited, so you can set up notifications for feature branches in one channel, and for release branches in another one.

Message placeholders

{name}

Full name of the build configuration, has the format "project_name :: buildconfig_name".

{number}

User defined build number.

{branch}

Branch display name, i.e. name to show to the user. Unknown if not applicable.

Please make sure that your VCS settings are correct!

See TeamCity Docs and #21

{status}

succeeded if build is successful, started if started, canceled if canceled, failed otherwise.

{link}

URL to view results page.

{mentions}

Slack users mentions only if build fails. Unknown users will be skipped.

{users}

TeamCity user name list only if build fails. Unknown users will be skipped.

{changes}

Concatenated description of head 5 changes from build with author name (from VCS) in square braces, e.g. My awesome feature [John Smith].

{reason}

Build problems that caused build failure when build is failed. Unknown if cannot detect.

{artifactLinks}

See Artifact links.

{allArtifactsDownloadUrl}

Link to download all artifacts as zip archive.

{artifactsRelUrl}

Artifacts relative path. It is necessary if you want to construct artifact link manually.

Parameters placeholders

You can also use project and build parameters, e.g. {%my.awesome.teamcity.param%}

Artifact links

In case you want to access build artifacts with third party web server (e.g. nginx) you can use this feature. Specify Public artifacts URL as root path served by your web server. And Artifacts mask in Build configuration. All other will be done automatically.

Sample nginx configuration:

location /art/ {
    alias <teamcity-data-dir>/system/artifacts/;
    autoindex on;
}

Message preview

By default Slack plugin sends messages as attachments. But there is one inconvenience — there is no message preview in push notifications. It can be easily fixed by turning off the Send message as attachment checkbox in Plugin setup.

Now Slack messages look like

Successful build with emoji

The message is prepended by Emoji , ⛔ or ⚪ for successful, failed and other build statuses respectively.

You can’t perform that action at this time.