Jenkins : Job Run UUID Plugin

This plugin has not been released yet. Hopefully released by the end of 2013.

Plugin Information

No information for the plugin 'job-run-uuid-plugin' is available. It may have been removed from distribution.


This plugin allows for tracking multiple executions of a job remotely.

Introduction

This plugin has been created to allow you to handle large numbers of multiple executions of a job more easily.

Each build is tagged with a UUID immediately on creation - allowing you to identify a build even before it leaves the queue and is given a "Run Id". 

You invoke the API as follows...

<jenkins>/job/<your-job>/buildId/execute

And it will respond with...

"attempts":0,"buildId":7,"building":true,"delay":0,"errorCode":0,"errorDesc":"OK","format":"json","responseCode":200,"uuid":"18712488-5a40-4ce7-bf6c-a05147a743ed"

You can then request the status of the job by calling...

<jenkins>/job/<your-job>/buildId/findBuild?uuid=18712488-5a40-4ce7-bf6c-a05147a743ed

It becomes very useful when you invoke jobs than there are executors as you can track an invocation even if it does not have a buildId yet. The response from /execute looks like this

Example

Say, for example, you wanted to send out a customised release note to each of your clients. You know which clients are particularly interested in a feature/bug fix as they mark it as "watched" in JIRA so you'd like to prepare a release note thanking them for their continued support and to list the bugs they are most concerned about at the top of the information you send out.

You have over 50 clients though - oh-no! - and your infrastructure can only take 6 executing jobs at once. This could take forever...

By utilising this plugin, you can kick off all 50 builds and then use the plugin to track them to completion. 

<jenkins>/job/release-notes/buildId/execute?client_name=Barbara&client_company=Foobar
<jenkins>/job/release-notes/buildId/execute?client_name=Jeff&client_company=Snafulle
<jenkins>/job/release-notes/buildId/execute?client_name=Fred&client_company=Mixsticks 
...