Last updated Mar 10, 2023

Rate this page:

Changelog

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.

Read our docs on getting support through the right channel.

10 March 2023

Announcement 2 new pre-migration app checks now available in CCMA v3.4.3 and above

We are excited to announce following 2 new app related pre-migrations checks in CCMA v3.4.3 and above. Customers will be able to proceed with the migration if any of this check fails.

1. Cloud app license check

This pre-migration check verifies that all apps participating in the migration plan have an active cloud app license installed on their cloud site instance. If the license for any of those apps is inactive, customers will be redirected to manage the app license on the cloud site. Free apps will pass the check.

2. Check for apps to verify if apps can receive migration notification

This pre-migration check verifies all apps participating in the migration plan are registered to receive migration notifications. This means the check will pass for the apps that have registered a webhook to receive migration events or apps that don’t require them to function. If this check fails, the customer will be directed to the marketplace partner support portal.

Watch the changelog for future updates when this feature will be available for Marketplace Partners in the Jira Cloud Migration Assistant (JCMA).

You can find more details about Atlassian offered app checks at: https://developer.atlassian.com/platform/app-migration/app-vendor-checks/#atlassian-offered-app-related-checks-that-run-by-default

6 March 2023

Announcement App vendor checks now enabled for customers in CCMA v3.4.3 and above

App vendor checks feature was first introduced in CCMA on 31 January 2023. This is now publicly released to customers from CCMA v3.4.3. This means any checks written and registered by vendor will always run for customers. For now, these checks are non-blocking for customers.

Read our docs for more information on how to build the pre-migration checks and write effective content for the checks.

More details

App vendor check feature allows you to create and run pre-migration checks for your customer’s app migration. This feature of the Cloud Migration Assistant allows you to:

  • detect and warn your customers about any issues that can affect their app migration

  • guide them to resolve potential pre-migration issues

31 January 2023

Announcement New feature to run pre-migration checks by Marketplace Partners now available in CCMA

The App vendor check feature is now also available for Marketplace Partners in the Confluence Cloud Migration Assistant (CCMA) version 3.4.0 and higher by enabling the feature flag migration-assistant.enable.app-vendor-check.

Read our docs for more information on how to build the pre-migration checks and write effective content for the checks.

Note:

Watch the Changelog for future updates about the public release of this feature for customers in the CMAs.

More details

App vendor check feature allows you to create and run pre-migration checks for your customer’s app migration. This feature of the Cloud Migration Assistant allows you to:

  • detect and warn your customers about any pre-migration issues that can affect their app migration

  • provide guidance to help them resolve potential pre-migration issues

16 December 2022

Announcement Atlassian support can now trigger transfer cancellation on customer's request

Atlassian support can now cancel transfers upon customer’s request. This was previously an experimental feature.

When this is requested, your cloud app will receive a new event with the type transfer-cancellation-requested and you may need to take an action.

7 December 2022

Announcement New feature to run pre-migration checks by Marketplace Partners in JCMA

We’ve added a new feature to the App migration platform that allows you to create and run pre-migration checks for your customer’s app migration. This feature of the Cloud Migration Assistant allows you to:

  • detect and warn your customers about any pre-migration issues that can affect their app migration

  • provide guidance to help them resolve potential pre-migration issues

Read our docs for more information on how to build the pre-migration checks and write effective content for the checks.

Note: The App vendor check feature is currently available for Marketplace Partners in the Jira Cloud Migration Assistant (JCMA) version 1.7.7 and higher by enabling the feature flag com.atlassian.jira.migration-assistant.enable.app-vendor-check.

Watch the Changelog for future updates about the public release of this feature for customers in the CMAs, and when this feature will be available for Marketplace Partners in the Confluence Cloud Migration Assistant (CCMA).

3 November 2022

Announcement New event type for server side listener failure

Server side listener failures can cause an app migration look stuck for long hours, as their cloud apps may not be aware of server side listener failures and miss setting a proper status to such app migrations.

To close this gap, App migration platform is introducing,

  • a new web hook event type ( listener-errored) to notify the cloud apps when there is a server side listener failure

  • a new connect end point to fetch details about the server side failure

You can read more details about this feature here.

More details

This feature is released on 24 November 2022 and is available for app migrations using CCMA v3.3.7 and JCMA v1.7.2 onwards.

17 August 2022

Announcement New event type for transfer cancellation

We are experimenting with a feature to cancel stuck transfers. Cloud apps may receive a new event with the type transfer-cancellation-requested.

As the platform evolves to cover more exceptional cases, in future there might be also events to notify marketplace partners that there was an error on their server-side migration listener.

19 July 2022

Deprecation Notice Phasing out our first-generation app migration listeners

We are starting to phase out our first-generation app migration listeners (AppCloudMigrationListenerV1 and CloudMigrationListenerV1) in favour of DiscoverableListener

More details

If your app has dependencies on either of the first-generation app migration libraries (app-migration-osgi and app-migration-tracker), you are required to plan for some changes if you intend to keep supporting App migrations.

15 June 2022

Added Added App migration platform rate limit details for Server app

Added more details on how to handle request rate limits from the P2 server app.

3 June 2022

Removed Support for more than 5 endpoints to receive App migration events has been removed

This change was originally planned for the 16th of May and has now been applied. We have monitored the usage patterns on this endpoint and no customer impact is expected.

31 May 2022

Announcement Removal of user impersonation requirements for bulk APIs

Following the announcement at MIG-812, the User Impersonation requirement to use the following Bulk APIs will be removed:
The Jira Cloud platform REST API - Bulk update custom field value
The Jira Cloud platform REST API - Bulk update entity properties

Requests made with User Impersonation will have their impersonation ignored.

26 May 2022

Added Added App migration platform rate limit details

Updated documentation to provide more details on possible 429 from calls made to App migration platform from cloud app.

For more details, refer to: https://developer.atlassian.com/platform/app-migration/rate-limiting/

12 May 2022

Announcement Removing impersonation requirement from Jira Bulk APIs.

Following tutorials are updated to remove the need to impersonate a user in order to use the Jira bulk APIs for entity properties and custom fields.

Refer to https://jira.atlassian.com/browse/MIG-812 for more details about this change.

29 March 2022

Added Added Jira Service Management namespaces to mapping list

Added Jira Service Management namespaces jira/servicedesk:requestType and jira/servicedesk:customerOrganization to mappings list.

18 March 2022

Announcement Updated workflow rules tutorial with a step to filter workflow rules that are yet to be processed.

Updated the tutorial for migrating app workflow rules to explain the step for cloud apps to filter the workflow rules that are yet to be processed.