Migration Checklist

✅ Learn about the differences between Data Center and Cloud

Use these resources to learn about feature parity between the two products: 

Note about APIs

When migrating scripts from Atlassian's on-prem to Cloud products, one common question is whether there's a straightforward way to translate the Java API to the REST API. The Java API used in Data Center is fundamentally different from the REST API used in the Cloud, meaning direct translations are rarely possible. However, the Cloud API does provide a rich set of functions which can be leveraged to achieve similar outcomes.

For more information on the Atlassian Cloud API, check out this page from Atlassian.

✅ Prepare

Back up your instance

Start by backing up your current environment, including all scripts and configurations. 

Review your current instance

Decide whether you need to migrate everything or declutter your instance. Then, figure out which scripts can be rewritten for the new environment and which scripts will need an alternative solution.

✅ Download and install ScriptRunner for Confluence Cloud

There are two ways you can download and install ScriptRunner for Confluence Cloud: from the marketplace or from your instance. Choose one and proceed: 

Install from the Atlassian Marketplace 

  1. Navigate to the Marketplace listing.
  2. Enter your team's details to get a pricing plan for ScriptRunner for Confluence Cloud and select Get it now. 
  3. Select which instances you want the product installed in.

    When you are logged in to your instance, they will automatically appear on this screen.

  4. Select Start Free Trial. 

Install from your Confluence instance 

If you would prefer to install from inside your Confluence instance, follow these steps.

✅ Migrate your macros

When you migrate from ScriptRunner for Confluence Server or Data Center to ScriptRunner for Confluence Cloud, most built-in macros are unsupported and need to be replaced with a custom Cloud macro to perform the same tasks. Check out the Custom Macros documentation for SciptRunner for Confluence Cloud to learn more.

There are currently three built-in macros that ScriptRunner for Confluence Cloud supports. These built-in macros are: 

For tips on migrating these macros to ScriptRunner for Confluence Cloud, check this out.

✅ Rewrite your scripts

Migration from Scriptrunner for Confluence Server/Data Center to ScriptRunner for Confluence Cloud will require your scripts to be rewritten. This is because the APIs and programming models differ significantly between Confluence Server/Data Center and Confluence Cloud.

Check out this Rewrite Scripts for ScriptRunner for Confluence Cloud Guide and ScriptRunner HQ to start.

🚀 Need help?

Check out our Development Services or contact us. 

On this page