Rate this page:
This page includes release notes and updates about the App migration platform for individuals who develop migration paths to move app data from server/data center to cloud.
Use this page to keep track of new or updated features, deprecations, and bug fixes.
The App migration platform public beta version is now available for Confluence Cloud Migration Assistant to use in production.
Discoverable Listener is now available for use in production as the following issues were fixed:
From 19 May 2022, the App migration platform will reduce the maximum page size to 1200 for mapping retrieval operations for both server and cloud app.
Read the Deprecation notice for page size of APIs to get the mappings by pages for more information.
We have added two new tutorials to help with migrating from the
atlassian-app-cloud-migration-tracker library to the Discoverable Listener.
Due to recent issues discovered in Discoverable Listener, at this time it is not recommended for use in production code. It is expected that the fix will be released in the next versions of each Cloud Migration Assistant.
Please watch these tickets for updates
With the latest release of the Jira Cloud Migration Assistant, apps are placed in 'stages' based on their demonstrated app migration success rates.
Read our documentation to understand more about how apps are placed in stages, and how the 'Assess your apps' screen displays app stages in the Jira Cloud Migration Assistant.
The app migration platform public beta version is now available for Jira Cloud Migration Assistant to use in production.
Starting from Confluence Cloud Migration Assistant 3.2.5 and Jira Cloud Migration Assistant 1.6.2, we are offering a new App Migration Listener that has weaker dependency on OSGi context.
By implementing the Discoverable Listener, your application won’t be affected by Cloud Migration Assistant restarts nor deactivation.
To start using it, import the new library
atlassian-app-cloud-migration-listener and follow the instructions at https://developer.atlassian.com/platform/app-migration/examples/
From 17 February 2022, the App migration platform will not be compatible with server apps using:
atlassian-app-cloud-migration-osgi library older than version
atlassian-app-cloud-migration-tracker library older than version
Read the deprecation of old versions of OSGI and tracker libraries for server apps for more information.
We have added a migration path readiness checklist to the documentation. We strongly recommend that Marketplace Partners use the checklist of steps on this page to assess the readiness of their migration path.
Apps must use the ‘Progress reporting’ feature as part of building their migration path. This allows apps to display the progress of the migration to customers in the Cloud Migration Assistant user interface. We have updated information in the developer documentation about using the Progress reporting feature.
From 01 December 2021, the App migration platform will not expose the
webhookEventType attribute. As a replacement, you will need to use the
Read the deprecation notice of webhookEventType values for more information.
From 01 December 2021, the App migration platform will not support using the
statusMessage attributes to accept migration progress reports. As a replacement, you will need the
Read the deprecation notice of progress endpoint DTO changes for more information.