Overview
Before migrating your Markdown extensions for Confluence app content from server to cloud, we recommend reading this Atlassian article to plan your migration.
This article contains the required information to migrate the app data from server to cloud. To migrate your pages from server to cloud, you must run the Confluence Content Migration Assistant (CCMA).
Also before migrating please be aware that the major difference between the server and cloud version of this app is that while on server you set up access to private content using an access token, on cloud access is instead configured by creating a link between Confluence and your Github account. This link authorises Github Macros to access content from your Github account.
Verification post migration
After performing migration using CCMA, you’ll find the migrated server tokens in the cloud apps' configuration, below tab Access tokens imported from Server.
Note: You will not be able to add new access tokens.
You can view and configure new links between Confluence and your Github account (existing cloud app feature) on the Connected Github accounts screen.
After migration, the migrated pages containing the Github macros which are migrated from server should continue to render as expected and are ready to use.
If you are facing any issue then please contact our Support team for assistance.
Differences between server and cloud versions
This section gives an overview of the differences between the server/DC and cloud versions of the app. Note that features available in both server and cloud versions are not listed in this article.
The following table lists the differences between the server and cloud versions:
Feature | Server | Cloud |
---|---|---|
Access to private Github content | Yes. You need personal access token to be configured. See details here. | Yes. You need to create a link between Confluence and your Github account, there by authorising your site to access content from your Github account. See details here. |
Macros | Macros use the configured personal access token to fetch data from given github repo. | Macros use the configured link to fetch data from given Github repo. |