Apps documentation
Issue SYNC for Jira Cloud
Issue SYNC for Jira Cloud
Introduction
Architecture & Versions
Development
Migration path
Last updated Nov 1, 2020

In this scenario we will show you how to set up a basic one-way synchronization between two JIRA Cloud instances:

  • Jira A
  • Jira B

The correct configuration order is presented below. Some actions need to be done in sequence.

1. Connection Jira A setup

  • Go to Jira Administration > Apps > ISSUE SYNC > Configuration
  • Click +Add a connection button
  • Fill the form with Name and Remote URL of Jira B
  • Click Create button
  • Local Authentication Key has been generated for this connection

2. Connection Jira B setup

  • Go to Jira Administration > Apps > ISSUE SYNC > Configuration
  • Click +Add a connection button
  • Fill the form with Name, Remote URL of Jira A and set Remote Authentication Key with Local Authentication Key from Jira A
  • Click Create button
  • Local Authentication Key has been generated for this connection

3. Connection Jira A setup - update

  • Click Edit link on Connection A
  • Set Remote Authentication Key with Local Authentication Key from Jira B
  • Click Save button

Synchronization configuration (optional) To speed up configuration exchange between Jira instances:

  • Click Synchronize configuration link on Connection A

  • Sync status of the connection changes to IN SYNC

4. Contract Jira A setup

  • Click Contracts tab
  • Click +Add new contract link in Connection A section
  • Set Contract name
  • Click Save button
  • Click +Create button in Create/Update triggers section
  • Set Trigger name. Select Project Name and Issue type to determine issues synchronized from Jira A
  • Click Create button

Create trigger

  • Click +Create button in Create/Update triggers section
  • Set Trigger name. Select Project Name and Issue type to determine issues synchronized from Jira A
  • Click Create button

5. Contract Jira B setup

  • Click Contracts tab
  • Click +Add new contract link in Connection B section
  • Set Contract name
  • Click Save button
  • Click +Add link in Remote Contract field
  • Select Contract A
  • Click Incoming Configuration tab
  • Click +Create button in Issue incoming mapping section
  • Set Project Name and Issue Type to determine which issues will be synchronized. Select the trigger created in JIRA A in Remote triggers field
  • Click Create button

Incoming mapping setup

  • Click Incoming Configuration tab
  • Click +Create button in Issue incoming mapping section
  • Set Project Name and Issue Type to determine which issues will be synchronized. Select the trigger created in JIRA A in Remote triggers field
  • Click Create button

Exposed fields configuration

  • Click Edit button in Exposed fields to receive section
  • Click +Add link
  • Select Local field and set Exposed Field name (used in Jira A as a label)
  • Click +Add button
  • Perform addition operation for every field, that should be exposed to Jira A
  • Click Save button

6. Contract Jira A & Jira B binding

  • Click +Add link in Remote Contract field
  • Select Contract A

7. Fields to send configuration

  • Click Edit button in Fields to send section
  • Click +Add link
  • Select Local field and Remote Field name, that should be synchronized
    Click +Add button
  • Perform addition operation for every field, that should be sent to Jira B
  • Click Save button

Trigger Config

  • Click +Add link in On which Jira event trigger create field
  • Select issue_created from the list
  • Click +Add link in On which Jira event trigger update field
  • Select issue_updated from the list

8. Enable Contract A & B

  • Click Contracts tab
  • Click Enable