DEV Community

Cover image for How To Sync Epics between Two Jira Instances
Teja Bhutada
Teja Bhutada

Posted on

How To Sync Epics between Two Jira Instances

Companies looking to sync Jira Epics internally or externally must use native or third-party applications.

One third-party option is Exalate, a bidirectional integration solution that syncs data between two Jira instances using simple scripts and custom triggers. It also works with Zendesk, Azure DevOps, ServiceNow, Salesforce, GitHub, etc.

In this article, you’ll learn how to sync Epics between two Jira instances using Exalate.

Use Cases For Two-way Jira Epic Sync

Some scenarios for syncing Jira Epics include:

  • Internal teams looking to consolidate data between their Jira sites,
  • Companies collaborating with MSPs, suppliers, vendors, or other companies,
  • Organizations going through a merger and acquisition,
  • Solopreneur connecting with an outsourcing partner.

Potential challenges

  • Unprecedented network timeouts
  • Poor data transformation
  • Retries after failure
  • Badly configured triggers
  • Scripting errors
  • Debugging

How Can Exalate Solve This Problem?

Exalate is the perfect solution for connecting two Jira Epics for the following reasons:

  1. It allows you to sync Jira epics and issues in a few clicks.
  2. Exalate’s Groovy scripting engine allows you to write custom rules for advanced use cases.
  3. It allows you to sync multiple epics and issues using the Bulk Exalate option.
  4. Exalate protects your data when sharing sensitive information.

Primary Requirements

When a user creates an Epic on one Jira Cloud instance, it should appear on the other instance without having to copy it manually. The changes should go both ways.

To get this working, the system admin needs to write sync rules to control the outgoing and incoming data. Next, Jira Query Language (JQL) triggers will be set up to automate the sync.

You also need to have the Exalate App installed on both instances, whether Jira Cloud or Jira On-Premise (Data Center).

How to Sync Jira Epics With Exalate

Step 1: Establish a Connection

Start from either instance; the process is the same.

On one of your Jira instances, click “Apps” in the top menu and then select “Manage your apps.” Then click “Exalate” to open the app console.

Click “Connections”, then click “Initiate Connection” to start.

On the next screen, enter the URL of the destination instance. Then select “Script” from the configuration options that appear.

Exalate Configuration Modes

Enter the name and description of the connection. Click “Next” to process.

Naming Exalate Connections

Click on “Copy invitation code”. Then head over to the other instance.

On the other instance, click “Accept invitation” and enter the invitation code. Then click “Next” to select the target project containing the Epic you want to sync.

Accept connection invitation

That’s all. If the connection goes through, the “Congratulations” screen will appear.

Exalate configuration success

Step 2: Edit the Connection

After setting up the local connection and accepting the invitation on the remote side, click the “Edit connection” icon (on the local side).

Go to the “Rules” tab and look for the “Outgoing sync” text field. Add the function Epic.send() to the console. This line of code sends out your Jira Epic and its contents to a remote instance.

Exalate outgoing sync

Click “Publish” to save and implement the changes.

Repeat the same procedure by opening the “Rules” tab on the remote instance (the receiving side). This time, go to the “Incoming sync” text field and enter the function Epic.receive().

Exalate incoming sync

The .receive() method tells the console to allow the remote instance to receive data from the sending instance. Click “Publish” to save the changes.

Once the connection is ready, head back to your Jira dashboard to create a new Epic — add a name and description.

Setting up sync panel

After creating the Epic, go to the sidebar and click “Open Exalate.” Next, click “Exalate” and choose the connection name you created earlier.

Wait for the status to go from “Waiting for Remote” to “Synchronized.” Then, click on the Remote Link, which will take you to the epic created on the other Jira instance.

Confirm replication success

You can see that the Epic has been replicated on the other Jira instance.

Afterward, go back to the local instance and add three issues. Then go back to the remote side and refresh to see the issues within the newly created epic.

Step 3: Create Triggers to Automate the Sync

If you don’t want to manually Exalate the issue, add triggers to sync the issue automatically. So, anytime you create an epic on one side, it instantly replicates itself on the other side.

To create a trigger, click “Triggers” on the left sidebar. Click “Create Trigger” to start configuring your issue or sprint.

Create trigger

You can write as many conditions as necessary. If you have instructions, you can add them as “Notes” to the trigger. Once done, click “Create” to complete the process.

Congratulations! You’ve now set rules and triggers to help you sync epics between two Jira instances.

If you still have questions or want to see how Exalate is tailored to your specific use case, book a demo with one of our experts.

Top comments (0)