A GoCD notification plugin which sends direct emails and Slack messages to the person who breaks a build
Switch branches/tags
Nothing to show
Clone or download
Latest commit b117d81 Oct 31, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
backend Updated Slack page Apr 20, 2017
gradle/wrapper Initial commit Apr 18, 2017
plugin Fixed wrong doc on message placeholder Sep 11, 2017
static Updated README Sep 7, 2017
.gitignore Updates to version 0.4 Apr 20, 2017
README.md Update README.md Oct 30, 2017
build.gradle Update build.gradle Oct 26, 2017
gradlew Initial commit Apr 18, 2017
gradlew.bat Initial commit Apr 18, 2017
settings.gradle Added backend Apr 20, 2017
test.sh Updated version 0.5 Apr 21, 2017

README.md

gocd-build-watcher-plugin

A GoCD notification plugin which sends direct emails and Slack messages to the person who breaks a build Screenshot Fail Screenshot Fixed

Installation

  1. Download the lastest release JAR from jCenter: Download
  2. Drop it under $GOCD_DIR/plugins/external
  3. Restart Go Server

Configuration

Accesing pluging Settings (on GoCD)

Settings 1 Settings 2

Access Go Server API

This plugin requires access to Go API to fetch status of previous job execution and material changes. If you are enforced to login before you can access the main pipelines screen, you need to provide a valid user/password to our plugin.

  1. Enter plugin settings
  2. Enter API username and password: Settings 3

Adding Slack notifications

As this pluging needs to resolve user's email into a Slack ID, a WebHook is not enough to work. You need to install our Slack App into your team and get an API token.

Profile Warning
You may see this warning when authorizing our app to work with your team. We will only access your team profile in order to match a email from a Material change into a Slack ID

  1. Install our app into your team:
    Add to Slack
  2. Copy your Slack API Token into GoCD's plugin configuration
  3. (optional) Configure a custom channel or slack id for the bot. If a channel is set, messages will still @mention a user. If not set, commits with an author that can't be resolved to a user in Slack will be posted to #general by default. Enter plugin settings and then: Settings 4

Adding Email notifications

  1. Configure your SMTP server details
  2. If you SMTP requires authentication, provide your account/password
  3. Provide a From email, the one our plugin will be sending email on behalf
  4. Provide an optional CC, this email will copied every time an email is sent

Customization

  • Pipeline Broken Message: sent to a user when a specific pipeline is broken (the build fails) by the last commit
  • Pipeline Still Broken Message: sent to a user when a specific pipeline was broken and the last commit didn' fix it
  • Pipeline Fixed Message: sent to a user when a specific pipeline was broken the last commit fixed it