This page describes
Before installing the plugin make sure that you're using:
First, you will need to configure your TeamCity instance:
When you're finished with the steps above, switch to JIRA and do the following:
Immediately after installation, the plugin displays the TeamCity tab on the Project, Version and Issue pages in JIRA and starts indexing all TeamCity builds looking for those containing JIRA Issue Keys.
Note: Issue Key is a JIRA issue ID. Normally, it's specified in a commit log message in a version control system integrated with TeamCity. For example, a developer commits a source code file adding the log message DEMO-5 Added compatibility with older browser versions, the build that includes this change will be shown in JIRA in the DEMO project and in issue DEMO-5.
While the plugin is analyzing the builds, you will see the the following message on the TeamCity tab.
Note: This process may take a while on large instances.
When the inital indexing is over, you will see all found builds on the TeamCity tab on the Project (shown below), Version and Issue pages.
If no relevant builds are found, you will see the message No associated builds are found. From now on, the plugin will update the build list in JIRA every 2 minutes.
Each issue in JIRA is assigned to a project and (optionally) to a version, therefore a build list displayed on the Project tab is compiled of the issues assigned to a given project, and a build list displayed on the Version tab is compiled of the issues assigned to a given version.
The TeamCity tab looks the same for issues, projects and versions. It contains the main build parameters, such as a start date, build duration, commit log, etc., and allows you to switch to TeamCity for detailed information.
The TeamCity Agents gadget shows whether the TeamCity agents are connected and enabled. You can add this gadget to your JIRA dashboard to have this information handy. If you're using the system dashboard which is displayed by default, you will need to create a custom dashboard and add the TeamCity Agents gadget.
You will see the gadget on your dashboard as shown below.