Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

Atlassian Connect framework is the fundamental building block for Cloud apps going into the future of the Atlassian Cloud infrastructure. All the Atlassian Cloud users are required to either install the app or migrate it from Server to Cloud to be able to use the Markdown for Confluence app on Cloud. This page explains:

  • All the aspects to keep mind while migrating from Server to Cloud
  • Migration process
  • Differences between the Server and Cloud version of the app

Perks of moving to Atlassian Cloud

  • Delivers all the new features of Markdown for Confluence and fixes more quickly to the users. User instances automatically receive new and improved capabilities as soon as the app is formally released on the Cloud. This compares to the approach taken when the latest Server version is released, users themselves need to upgrade their instances.
  • Minimizes cases or severity where Confluence Cloud updates may impact the proper behavior of the macros. While rare, we have experienced a few of these cases over the last few years that have caused customer pain. While this provides long term benefits, there are some near term disruptions.
  • Allows Atlassian to deliver more significant infrastructure improvements for the benefit of all Cloud users.

Administrator's role

Nothing for the conversion. The conversion is done by Atlassian at the appropriate time for your instance as part of the rollout staging. Once your instance is converted, it is recommended that Administrators check any critical pages to ensure behavior is as expected. Please report any issues immediately after looking through the known problem list below.

...

Description

Before migrating your Markdown for Confluence app content from server to cloud, we recommend reading this Atlassian article to plan your migration. 

Note

Administrators must ensure that the following feature flag is enabled in the server instance as a part of the pre-migration setup:

  • migration-assistant.app-migration.feature: <Confluence_URL>/admin/darkfeatures.action

Refer to the Getting started page from Atlassian for more information about the prerequisites for the migration.

This page explains:

  • Migration process
  • Differences between the server/DC and cloud version of the app

Migration process

...

  • server to

...

...

  • .
  • App installation - Install the app from Marketplace.

...

Note
titleOn completion of migration from version 3.6.0:
  • All global configuration and profile data in the Configuration page are transferred from the server instance to the cloud instance as specified in the Cloud Migration Assistant wizard.
  • Points to note about profile data migration:
    • For profiles with distinct names on the server/DC and cloud instances, the profiles from both server/DC and cloud instances are combined and listed under Configuration > Profiles as-is.
    • For profiles with the same name in both server/DC and cloud instances, the profile configurations available on the server/DC overwrites the profile configuration on the cloud instance. Thus, only one copy of the profile configuration, taken from the server/DC, is available on the cloud, and the original configuration details on the cloud are overwritten. 

      Info

      Consider an example that if:

      • Profiles in server/DC: A, B, and D
      • Profiles in cloud: A (profile with the same name as in server, and has the same or different configuration), and X

      After migration is completed, the Configuration page of the cloud instance now contains the A (with configuration details as in server/DC), B, D, and X profiles.


  • If multiple migrations are performed on the same cloud instance, the latest migration takes precedence.
  • Any subsequent migrations performed on the same cloud instance only adds or merges the data, but does not delete any existing data.


Info
titleImportant information:
  • The migration of data from server to cloud is an independent process from app installation or configuration in your cloud instance. We recommend that administrators verify that all your data (configuration as well as your Confluence pages) are displayed properly after the migration process is completed. Please report any issues immediately after looking through the known problem list.
  • We capture certain details, excluding private user data or any personally identifiable information, during the migration process to help us improve our app continually. Refer to Analytics data to know more about the what information is collected.

Anchor
differences
differences
Differences between

...

server/DC and

...

cloud versions

All the macros available in the Server server/DC version are supported in the Cloud cloud version as well. The following table lists the macros' parameters and features that work differently in Server server and Cloudcloud:

Parameter/FeatureServerCloudNotes
URL whitelistingSupported natively by Confluence and configured using the Global Configuration pageAdministrators must manually whitelist the URLs in the Global Configuration page, because Confluence Cloud cloud does not natively support URL whitelisting.For more information, refer to CLOUD-2636.
Rendering Markdown content having angle quotesSupportedNot supportedFor updates on this feature, refer to MARKDOWN-388.
Rendering links with spaces between text and linkSupportedNot supportedFor updates on this feature, refer to MARKDOWN-387.
Linking pages to other applications using AppLinksSupportedNot supportedFor updates on this feature, refer to MARKDOWN-375.
Exporting a page as an attachment, or, in as a PDF or Word formatsSupportedNot supported

For updates on exporting a page as an attachment feature, refer to MARKDOWN-216.

For updates on exporting a page in PDF or Word formats feature, refer to MARKDOWN-264.

Using customized CSS for tables in macrosSupportedNot supported

For updates on this feature, refer to MARKDOWN-261

Please note that all the other parameters function the same in both versions of the app.

Problem reporting

If you experience any problems or behavior changes that are unexpected, refer to Help and open a ticket with us. This helps us identify and prioritize fixes and improvements.

Known issues

Jira Legacy
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
maximumIssues20
jqlQueryproject = MARKDOWN AND issuetype in (Bug, Improvement, "New Feature", Story, Task, Sub-task) AND status in ("In Progress", Open, Queued) AND component = cloud
serverId729d679a-302c-339f-958b-015e107badcd