Last updated Oct 21, 2021

Rate this page:

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.

Scenarioatlassian-app-cloud-migration-listeneratlassian-app-cloud-migration-osgiatlassian-app-cloud-migration-tracker
When Cloud Migration Assistant disablesNo changeListener deregisters, and your server app stops runningListener 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 disablesNo changeListener deregisters without affecting the Cloud Migration AssistantListener deregisters without affecting the Cloud Migration Assistant
On upgrade of Cloud Migration AssistantNo changeListener 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 disabledStarts the server app normallyStarts the Cloud Migration Assistant as a dependencyStarts 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 changeScenario is not applicableThe Marketplace Partner app registers automatically.

Rate this page: