Add notifyStash global function

global-library-examples/notify-stash/README.md

@@ -0,0 +1 @@
+This global function allows jenkins to notify stash of build status for a given commit. It uses the withCredentials and sh steps as well as curl to communicate with stash.

global-library-examples/notify-stash/notifyStash.groovy

@@ -0,0 +1,31 @@
+/**
+ * Notify stash of build status for commit
+ *
+ * @param status{String} INPROGRESS | SUCCESSFUL | FAILED
+ * @param message{String} Message to record in stash
+ * @param gitCommit{String} Full hash of git commit
+ */
+def call( status, message = "", gitCommit )
+{
+    env.USERNAME = env.PASSWORD = ""
+
+    def postData = """{
+            "state": "$status",
+            "key": "$env.JOB_NAME #$env.BUILD_NUMBER",
+            "url": "$env.BUILD_URL",
+            "description": "Built by Jenkins: $message"
+        }"""
+
+    // CREDENTIAL_ID_IN_JENKINS should be replaced with your stash user credentials
+    // that have been stored in jenkins.  
+
+    withCredentials([[$class: 'UsernamePasswordMultiBinding',
+                      credentialsId: CREDENTIAL_ID_IN_JENKINS,
+                      usernameVariable: 'USERNAME', passwordVariable: 'PASSWORD']])
+            {
+                def stashUrl = "https://YOUR_STASH_SERVER/rest/build-status/1.0/commits/$gitCommit"
+                def headers = "-H \"Content-Type: application/json\""
+                def credentials = "--user $env.USERNAME:$env.PASSWORD"
+                sh "curl $credentials $headers -X POST -d '$postData' $stashUrl"
+            }
+}