This feature is available for JIRA Server only.

Starting from version 2.2.0, TeamCity Integration for JIRA add-on allows you to manage the TeamCity Build Runner custom field. It allows you to remotely run builds on TeamCity server from JIRA.

Before proceeding to configuration of this custom field, please refer to the documentation about management of custom fields in JIRA.

Adding a Custom Field

  1. Navigate to JIRA Administration > Issues > Fields > Custom Fields.
  2. Click Add Custom Field.
  3. In the Select a Field Type form, switch to view all custom fields and enter 'TeamCity' into the search field.
  4. Select TeamCity Build Runner field.
  5. Click Next.
  6. Specify the field name and its description.
  7. Click Create.
  8. Select the screens where you want to display this field.
  9. Save the configuration.

Configuring the Custom Field

  1. Locate the newly added custom field and click the cogwheel button.
  2. Click Configure.
  3. On the opened page, click Edit Default Value.
  4. Select the appropriate TeamCity server, project and build configuration. You can also add an optional comment and define the build parameters.
  5. Optionally, you can allow users to view and edit the comment appended to the build. You can also allow users to view and edit properties which the build is triggered with.
  6. Click Set Default.

Once you have configured and added the custom field, you can remotely run builds in TeamCity from JIRA.

Adding Build Parameters into Custom Field Configuration

You can add one or multiple build parameters into configuration of the custom field.

For example, if you want to add one parameter with the value so you have to specify the following:

 

teamcity.build.branch=your_vcs_branch_name
# This build parameter defines which branch to choose for build creation. It may look like: teamcity.build.branch=2.2.0
If you want to add multiple parameters, you need to use the ';' (semicolon) as a separator for multiple parameters, as follows:
teamcity.agent.name=Windows2012R2;teamcity.build.branch=2.2.0
If you want to pass the issue key to TeamCity for mapping the build to issue, you need to add the following property:
issue_key=$JIRA_KEY

For the list of accepted build parameters, see TeamCity documentation.