What's here

This page lists:

sample applications that illustrate how to use the App migration platform
dependencies you will need to use the App migration platform

Sample applications

Use our repository to view sample applications that demonstrate various ways of implementing a migration listener for your server app with Confluence and Jira, and a sample Connect app. These samples are subject to change, and we have created them to demonstrate various concepts of pre-migration, migration and post-migration.

Dependencies to use the App migration library

This example shows our recommended approach to integrate with the Cloud Migration Assistants using atlassian-app-cloud-migration-listener. You can also find examples for the previous integration methods: atlassian-app-cloud-migration-osgi and atlassian-app-cloud-migration-tracker

Those dependencies are mutually-exclusive. You should pick the one that best suits your needs and never combine them.

A version catalogue and information about libraries end-of-life policy can be found on the library version page.

Compare the dependencies

The following table compares the atlassian-app-cloud-migration-listener, the atlassian-app-cloud-migration-osgi and the atlassian-app-cloud-migration-tracker dependencies.

Scenario	atlassian-app-cloud-migration-listener	atlassian-app-cloud-migration-osgi	atlassian-app-cloud-migration-tracker
When Cloud Migration Assistant disables	No change	Listener deregisters, and your server app stops running	Listener deregisters. Server app restarts and monitors for activity on the Cloud Migration Assistant. Automatically registers the listeners when server app detects activity on the Cloud Migration Assistants
When server app disables	No change	Listener deregisters without affecting the Cloud Migration Assistant	Listener deregisters without affecting the Cloud Migration Assistant
On upgrade of Cloud Migration Assistant	No change	Listener deregisters. Server app restarts after the Cloud Migration Assistant begins running.	Listener deregisters. Server app restarts after the Cloud Migration Assistant begins running. Server app registers listeners automatically when it detects the Cloud Migration Assistant's presence
On starting the server app when the Cloud Migration Assistant is disabled	Starts the server app normally	Starts the Cloud Migration Assistant as a dependency	Starts the server app normally, while monitoring for the Cloud Migration Assistant's presence. Server app registers listeners automatically when it detects the Cloud Migration Assistant's presence
When the Cloud Migration Assistant is initially disabled. The server app runs, and then the Cloud Migration Assistant is enabled.	No change	Scenario is not applicable	The Marketplace Partner app registers automatically.