Last updatedJun 24, 2019

Developing apps for Atlassian Data Center products

This page covers Data Center app development for the Atlassian Marketplace. On this page, you'll find best practices for developing and testing an app to run in a clustered environment. This page also contains instructions for submitting your Data Center approved app for publication in the Marketplace.

About Atlassian Data Center products

The Data Center deployment option for Atlassian products is specifically designed for high availability and performance at scale. Data Center instances run on multiple servers or nodes, and point back to a single relational database. For this reason, we refer to Data Center instances as clustered.

Data Center products are licensed on a subscription (not perpetual basis), with subscriptions recurring annually. Customers can apply their license key to multiple (unlimited) nodes.

Building apps for Data Center

As with the Server deployment option, Data Center apps are built using the Atlassian plugin software development kit (SDK). For further information, see Getting started with the Atlassian Plugin SDK.

The SDK can be used to build apps for the following Data Center products:

  • Bitbucket
  • Confluence
  • Jira Service Desk
  • Jira Software

Atlassian has developed guidelines for developers to follow as best practices when they're building apps for a Data Center environment.

First and foremost, before getting started building your app, please read the Guidelines for Data Center app development.

These guidelines include both general and product-specific recommendations, as well as details on testing your app with large a data set.

Determining the app version on a node

Nodes run the latest version of an app by pulling the plugin jar file from the shared home. To get the version of an app in the shared home, check the <version> value inside the app's atlassian-plugin.xml file. If there are multiple values, nodes use java.lang.String#compareTo to determine the latest version.

Publishing your Data Center app in Marketplace

Atlassian customers who've chosen the Data Center deployment option have a high standard of reliability and performance at scale for both Atlassian products and third-party Marketplace apps. For this reason, before allowing an app to be published as Data Center approved in Marketplace, we require the developer to demonstrate the app's readiness to be deployed in a Data Center environment.

Here is a brief statement of the requirements for Data Center apps in Marketplace:

  1. Complete a technical readiness checklist
  2. Test your app and document the results
  3. Provide support escalation details
  4. Create your Marketplace submission

To learn about the requirements in detail, see Submitting your Data Center app.

Marketplace pricing for Data Center approved apps

If you invest significant research and development resources in creating a Data Center approved version of your app, you might raise the largest tier prices by a small amount. As you consider this option, keep in mind that all Marketplace visitors see the same pricing tables, regardless if they use Jira Data Center clustered on multiple servers or Jira running on a single server. Customers are billed based on their product license. 

Though Data Center licenses are sold in 1000-user blocks, 1000-user pricing tiers for apps are not yet available. In the interim, customers can purchase a Server license for apps equal to (or greater than) their Data Center license. Just like Data Center products, customers can then apply these license keys to an unlimited number of nodes running their instance.