Trigger a Build

There are two ways to trigger a build from within Jira.

  1. Manually by using the Trigger Build dialog.
  2. Automated by configuring the ‘Trigger a build in Jenkins’ Workflow post function.

Trigger a build manually

Builds can be triggered from within Jira using the Build issue action or by opening the Issue Action panel and using the button Trigger a Build to open the Trigger Build dialog box.

With the Trigger a Build dialog open, you can simply select related Jobs or use the auto-complete search box to search for other jobs.

Trigger a build as part of a transition

Builds can be triggered as part of an issue transition by configuring the ‘Trigger a build in Jenkins’ workflow post function.

The workflow post function can be configured to trigger a build of a specific job, or all jobs related to the issue being transitioned. It can also be configured multiple times to trigger a build of multiple specific jobs.

Triggering a Parameterized Build

Administrators can configure which issue fields are passed to Jenkins when triggering a build, see Parameter Issue Fields.

Issue fields are only passed to Jenkins if the field was enabled as parameter issue field, and the field has a value on the issue where the trigger was sends from. Parameter names are created by taking the issue field name and replacing any space with an underscore. The Jira Integration for Jenkins plugin will match parameters to actual job parameters.

By default, the following parameters are available even if no issue fields are configured as build parameter:

Parameter Names Description
issueKey, issue_key Key of the issue where the trigger was send from.
issueUrl, issue_url URL of the issue where the trigger was send from.

Matching of Jira send parameters to actual job parameters is case-insensitive. For example, if the ‘Fix versions’ field in enabled, Jira sends a parameter named ‘Fix_versions’ and Jenkins will match ‘Fix_versions’, ‘fix_versions’ and ‘FIX_VERSIONS’.

Access Trigger Data

You can use the key of the issue from where you triggered the build in Jira within your build in Jenkins. When a build is triggered from Jira a special build cause is used, this cause is of type org.marvelution.jji.trigger.JiraCause and contains two fields issueKey and by, which are both accessible through a getter, getIssueKey() and getBy() respectively. The by field contains the Display name or id of the user that triggered the build from Jira, the issueKey field as is describes contains the key of the issue in Jira.

If you want the user’s id to be sent instead of the display name, then select the User Id option, see Configuration User Id vs Display Name.

So you could obtain and use the issue key using the following Jenkins pipeline snippet.

def jiraCauses = currentBuild.getBuildCauses('org.marvelution.jji.trigger.JiraCause')

// This results in a JSON array for Jira Trigger build causes like this:
//[
//  {
//    "_class":"org.marvelution.jji.trigger.JiraCause"
//    "shortDescription":"Started by admin through TEST-10",
//    "by":"admin",
//    "issueKey":"TEST-10"
//  }
//]

def issueKey = jiraCauses[0]['issueKey']

Or for short.

def issueKey = currentBuild.getBuildCauses('org.marvelution.jji.trigger.JiraCause')[0]['issueKey']

You can also obtain the issue key through the raw build reference, see snippet below.

def issueKey = currentBuild.rawBuild.getBuildCauses('org.marvelution.jji.trigger.JiraCause').getIssueKey()