Jira

Overview

The Jira integration requires the Git Integration for Jira __ app, which is found in the Atlassian Marketplace. Using this app, you can configure your Copia repositories to work with Jira to track changes to Git commits and branches.

For this integration, we will first add the app into your Jira account, and then configure the integration by setting up an index.

Other Git integration apps are available for Jira in the Atlassian Marketplace, and may work with Copia. We recommend you use the linked app due to its wide usage and ease of setup.

Configure Jira

Our first step will be to add the the Git Integration for Jira app to your account.

To do this, head to Jira, click on the Settings drop-down, and select the Apps option. Click the Manage Apps section on the left side of your screen. Select the Git Integration for Jira app and press the Configure button.

You should now be on the Manage Integrations page. Click on the Add Integration button.

You will be prompted to select the integration type. Choose the Single Git Repository Integration (Plain Git) option to continue.

Navigate to the repository you want to configure the integration for. Click the Create Clone dropdown and copy the repository URL to your clipboard by clicking the Copy button.

Paste the URL you just copied into the Host URL field in Jira. You'll also need to fill out the Login and Password fields with your Copia credentials. This will grant Jira access to the repository. Click on the Add Integration button to continue.

Click the Settings icon on your new integration and choose the Edit Integration option.

Select the Feature Settings option in the left menu, and scroll down to the Web Linking section. Configure the fields using the provided snippets.

When copying/pasting the below paths, make sure to replace <repository URL> with the repository URL you used above for the Host URL field.

Changeset Format:
<repository URL>/commit/${rev}

File Added Format:
<repository URL>/commit/${rev}#diff-${num}

File Modified Format:
<repository URL>/commit/${rev}#diff-${num}

File Deleted Format:
<repository URL>/commit/${rev}#diff-${num}

Branch Format:
<repository URL>/src/branch/${branchname}

Tag Format:
<repository URL>/src/tag/${tagname}

Once complete, your settings should look similar to what appears below. Remember to click the Save button.

Scroll to the top of the screen and select the Indexing Triggers option. You can also navigate to this page by going back to Manage Integrations and choosing the Indexing Triggers option.

Use the toggle to enable Indexing Triggers. Take note of Secret Key and Webhook URL -- you'll need them for the final steps.

Create a Webhook in Copia

In Copia, navigate to the repository you connected to Jira. Navigate to the Settings tab and choose the Webhooks section. Click on the Add Webhook button and select the Copia option.

Copy and paste the Secret Key and Webhook URL from Jira into the Secret and Target URL fields in Copia. Be sure to choose All Events for the trigger option. Click the Add Webhook button to complete the integration.