Skip to main content
Version: Early Access

TeamForge—Jira Cloud Integration

TeamForge Jira Cloud Support​

TeamForge 24.0 now supports TeamForge Jira on Jira Cloud.

Before You Begin

Install RPM and Configure Site Options in TeamForge​

  1. Use the following command to download and install the RPM package: 
    wget <RPMURL>
  2. Edit the site-options.conf file located at /opt/collabnet/teamforge/etc/site-options.conf and add the following token: 
    server-01:SERVICES=jira
  3. Provision services. 
      teamforge provision -y

Install the TeamForge-Jira Associations Add-on in Jira Cloud​

  1. As a privileged Jira admin, log in to Atlassian Homepage and navigate to Home > Jira Service Management.

  2. In the Create a new site, enter a site name of your choice to create a site address.

  3. Navigate to Jira Service Management homepage and click More > Apps > Manage your apps.

  4. In the User-installed apps area, click Settings and check the Enable development mode checkbox in the Settings pop-up window.

  5. In Upload app pop-up window, enter the app descriptor URL in the following format and click Upload:

    <hostname>/tf-jira/

  6. Expand TeamForge Associations to view the installed Jira version and other associated details.

Configure the Jira Integration Plugin​

Configure the add-on from the Configuration page to notify TeamForge about the Jira issues.

  1. Log in to Jira Service Management and click the Settings (gear) icon located at the top right corner.

  2. In the Settings, choose Systems > Configuration.

  3. Enter valid TeamForge log in credentials in the Username and Password fields.

    note

    The user whose credentials are provided must have API permissions in TeamForge, or the user should be a Project Admin.

  4. Enter the Webhook URL in the Webhook URL field.

    note

    You can generate the TeamForge Webhook URL using the create_webhook_event.py script.

  5. Click Save to save the configuration.

    Once the configuration is saved, Jira issues can be pushed to the configured Webhook URL.

Map TeamForge with Jira Project​

As a Jira site administrator, you can enable TeamForge mapping for one or more Jira projects. This reflects the changes in Jira issues mapped to TeamForge in the production TeamForge event data store.

  1. Navigate to Jira Service Management homepage and click the Settings (gear) icon at the top right corner and choose Systems > Manage.

  2. In the Association window, select your project from the Available List.

  3. Click Save.

    The TeamForge is now mapped in the corresponding Jira project.

Viewing Associations inside Jira​

Enable TeamForge for a Jira Project

  1. Navigate to Jira Service Management homepage, click Projects dropdown that lists the created project.
  2. Click the Settings (gear) icon located at the top right corner, and choose Systems > Manage.
  3. In the Associated window, select your project from the Available List.
  4. Click Save.

View TeamForge Associations

  1. Navigate to Jira Service Management homepage and choose your project from the Projects dropdown list.

  2. Click Queues to view the list of issues created in this project.

  3. Click a project from the table and scroll to the bottom to view the project associations.

    For more information, see Associate Jira Issues to Version Control Commits.