App Integrations with CMJ
Who can use this information
App vendors who want to allow their customers to move app configuration and data from one Jira instance to another.
Jira customers who develop apps for internal usage and want to move the app configuration and data between Jira instances.
Developers who want to integrate apps with Configuration Manager for Jira (CMJ) for app data and configuration migration purposes.
App Integrations with CMJ
Integrate your apps with Configuration Manager for Jira (CMJ) to migrate their configuration and data between Jira instances.
App configuration and data migration with CMJ
App Integrations is a platform we've built for Atlassian vendors who:
build Jira apps, and
want to add the ability for configuration and data migration to their apps.
The platform allows you to integrate your apps into our Configuration Manager for Jira (CMJ) app. CMJ is a Jira configuration and change-management tool used by Jira admins to move and migrate Jira configurations, such as projects, custom fields, workflows, etc., from one instance to another.
We've developed an extension to CMJ that provides the same features for migrating app configuration and data to Jira admins. It is called the Configuration Manager Service Provider Interface (SPI).
Integration is done with easy-to-use endpoints provided by the SPI. Vendors’ development teams must connect their apps to these endpoints to integrate with CMJ.
The interface has two versions: Server/DC SPI for Jira server apps and Cloud SPI for Jira Cloud apps.
Types of integrations
App Integrations offers two types of integrations. The type you choose depends on the Jira platform and the ability you want to build in your app.
Take a look at the Integration types document for more guidance.
Integration with CMJ for server-to-server migrations
Integrate your app with CMJ, and your customers will be able to move your app’s configuration and data from one Jira Server/DC instance to another.
To allow such migrations, you must integrate your server app with CMJ using the Server SPI’s endpoints.
Learn more about this integration type
Integration with the Cloud Migration Tool and CMJ Cloud for server-to-cloud migrations
To allow your customers to move your app’s configuration and data from a Jira Server/DC instance to a Jira Cloud instance, you need to:
Integrate your server app with the Configuration Manager Cloud Migration Tool using the Server SPI’s endpoints.
Integrate the relevant cloud app with CMJ Cloud using the Cloud SPI’s endpoints.
Learn more about this integration type
Supported configuration types
The types of app configuration and data that can be moved or migrated are:
For server-to-server migration: workflow elements, custom fields, project elements, dashboards, arbitrary app data, and global configuration.
For server-to-cloud migration: workflow elements.
Already integrated apps
Many vendors have already successfully integrated their apps with CMJ. As a result, their customers can now move their app configuration and data from one Jira instance to another.
Go to the List of all integrated apps document to see the apps already integrated with CMJ and their integration types.
Vendor Integration Corner
We’ve built documents and developer guides that will lead your teams along the way to the integration. Visit the Vendor Integration Corner, where you’ll find the complete developer guides for each of the SPI versions: