Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

The app stores everything within the page for its Confluence macro, so the app specific data itself is already converted with the Confluence Cloud migration assistant.

However the macro keys are different because the server/DC and cloud edition are different apps. Currently, the macro keys have to be changed manually before the Confluence Cloud migration.

Manual migration of macro keys

These are the macro keys for the two different app hosting types:

  • Server/DC: ipython

  • Cloud: ipython-notebook-viewer

Before you migrate from Confluence Server/DC to Cloud, you must migrate all macro keys of the Jupyter/IPython notebooks on all pages where you use the app.

To find out on which pages you use Jupyter notebooks, you can use the “Macro usage” page in the Confluence admin section: http://CONFLUENCE-SERVER/admin/pluginusage.action

To change the keys:

  1. Install Atlassian’s free Confluence source editor app

  2. Open a page where the Jupyter macro is used

  3. Click on the “edit page” button

  4. Click on the “edit source” button:

  5. Update all macro names from ipython -> ipython-notebook-viewerby using the search-replace feature of the source editor. Click “Replace all” to change all keys

  6. Save page

Once you did this for all pages where you use the macro, you can use the Confluence Cloud migration assistant and the macro should be rendered correctly in your new Cloud Confluence spaces.

To automate the macro key change process, you can also use a batch update solution like Adaptavist ScriptRunner provides. For more information on how to batch update all pages the macro uses, please see this guide.

Macro notebook reference differences

Because there are internal differences within the server/DC and cloud editions of the app, not all features are available and some require additional work which is not done yet:

Server/DC feature

Available in Cloud

Remarks

Reference notebook by URL

Just works

Reference notebook by attachment

Yes, but migration not working yet

No manual workaround, support for attachments is coming soon with an update for the cloud edition of the app

Reference notebook by Bitbucket Server

Not available

Not supported, as the Cloud edition does not yet provide support for including files from Bitbucket Server/DC (planned, is on our roadmap)

  • No labels