Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Talk
idtalk-901


Numbered Headings
start-numbering-ath2

What TeamCity versions are supported by the add-on?

The add-on supports TeamCity 9.0 1 and newer versions.

What roles and permissions should the user have that is used for integration between JIRA and TeamCity?

You need to grant roles of Project Viewer and Agent Manager to this user account. You need also to create a custom user role (for example, User Profile Viewer) and grant the 'View user profile' permission to it in TeamCity.

What is initial data indexation?

Initial data indexation is an automatic procedure that is launched once you add a connection to TeamCity server in JIRA Cloud. It indexes TeamCity build data for quick data accessibility when the user views the related projects or JIRA issues.

How often is data index updated?

Data index is a set of TeamCity build data that the add-on uses for display in projects and issues. Once the initial data indexation is complete, the add-on updates the data index every 3 minutes and when the user opens the TeamCity tab for the whole project or a specific JIRA issue. If users do not view TeamCity data in JIRA Cloud, the add-on does not temporarily update the index.

Can I configure the data indexation parameters?

Unfortunately, not for now. You can vote for this feature.

Can I remotely trigger builds in TeamCity from JIRA

Is it possible to use the Fixed in Build field?

Unfortunately, no. This feature is not available for JIRA Cloud, but you can vote for it.

Is it possible to remotely triggers builds in TeamCity from JIRA?

Unfortunately, no. This feature is not available for JIRA Cloud, but you can vote for it.

Is it possible to show TeamCity gadgets on JIRA dashboard?

Unfortunately, no. This feature is not available for JIRA Cloud, but you can vote for it. 

Can I configure the data indexation parameters?

Unfortunately, not for now. You can vote for this feature.

What firewall

settings should

rules configuration do I set up for

correct

add-on operation?

For correct operation of the add-on when TeamCity server is behind firewall. you need to open the portSet up the firewall rules configuration, as follows:

PortURL ExampleDescription
80http://yourteamcity.comIf using the standard HTTP protocol with the default port.
443https://yourteamcity.comIf using the standard HTTPS protocol with the default port.

Custom Port

(for example, port 7777)

https://yourteamcity.com:7777

or

http://yourteamcity.com:7777

 If using the custom, you will have to open this custom port. The custom port will vary.
  1. Whitelist the IP addresses 34.193.46.228, 44.217.201.16 of our add-on service.
  2. Allow the inbound connections through ports 80 (HTTP) or 443 (HTTPS) or any other custom port that you specified in the parameters of TeamCity servers during add-on configuration.
Info

Under specific circumstances the allocated IP address may change. Please start watching the add-on on the Atlassian Marketplace to receive notifications about any updates in the add-on.

I cannot generate a trial license for the add-on in JIRA UPM. What can I do?

You may encounter this issue when you click the Free Trial button in JIRA UPM. After clicking this button,you just get the page reloaded and the trial license is not applied.

This issue is caused by insufficient permissions. Please ensure that you are assigned to the 'site admins' group or ask the JIRA administrator registered in this group to request a trial license for the add-on.

No build data is available after the successful setup and data indexation when using IIS for running TeamCity

You may encounter this issue when your TeamCity operates on the basis of Microsoft's IIS. After the successful add-on setup, its configuration, and initial data indexation you may find no build data in JIRA issues.

The issue is caused primarily by special characters that IIS may treat as invalid when performing HTTP requests to TeamCity. TeamCity REST API uses colon (':') for processing requests that fetch information about related issues, as follows:

Code Block
https://teamcity.jetbrains.com/httpAuth/app/rest/builds/id:799596/relatedIssues?fields=issueUsage(issue)

To resolve this issue, please do the following:

  1. Locate the web.config file on the IIS server and open it.
  2. Add or edit the RequestPathInvalidCharacters property (if it already exists).

  3. Remove the unnecessary characters that should not be treated as invalid by IIS, as follows:
Code Block
<system.web>
	<httpRuntime requestPathInvalidCharacters="<,>,*" />
</system.web>

Optionally, you can remove all of them. Prior to doing this, consult the infrastructure support or data security team for any possible impacts of this in your corporate environmentAll the operational servers are located in US region (Amazon WS). We cannot provide the IP address or the range of IP addresses for adding to trusted, as the application uses servers with dynamic IP addresses that may vary.