Data Center add-on development
This page covers JIRA and Confluence Data Center add-on development for the Atlassian Marketplace. On this page, you'll find links to Confluence or JIRA-specific resources concerning add-on development and testing in a clustered environment. This page also provides instructions for listing your Data Center-compatible add-on in the Marketplace.
About JIRA and Confluence Data Center
JIRA and Confluence Data Center are 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 of JIRA and Confluence as clustered.
Data Center versions of Confluence and JIRA are sold in 1000 user blocks as annual licenses. These licenses are not perpetual, and customers can apply the license key to multiple (unlimited) nodes.
Data Center add-on development resources
JIRA Data Center add-on development
- Configuring a clustered JIRA development environment
- Developing a Data Center-compatible add-on for JIRA
- Testing your Data Center-compatible add-on in JIRA
Confluence Data Center add-on development
Develop future versions as Data Center compatible
If you're starting with an add-on used in standard JIRA and Confluence Server instances, we recommend developing with Data Center compatibility in mind for all future versions. If you already maintain a standard add-on for JIRA or Confluence Server, you might be tempted to simply fork your code and develop separate versions. Instead, we recommend using a single set of source code for future add-on releases—if you develop your add-on following the above links, it should play well with standard JIRA and Confluence instances in addition to clustered Data Center instances.
Marketplace pricing for Data Center-compatible add-ons
If you invest significant research and development resources in creating a Data Center-compatible version of your add-on, 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 application license.
Though JIRA and Confluence Data Center licenses are sold in 1000-user blocks, 1000-user pricing tiers for add-ons are not yet available. In the interim, customers can purchase a Server license for add-ons equal to (or greater than) their Data Center license. Customers can purchase 2000, 10,000, or 10,000+ user tiers. Just like JIRA and Confluence Data Center, customers can then apply these license keys to an unlimited number of nodes running their instance.
How the Marketplace determines Data Center compatibility
When you list your first cluster-compatible add-on version in the Marketplace, modify your
atlassian-plugin.xml descriptor file. This tells the Marketplace and UPM that your add-on is compatible with Data Center instances. Add the following parameter inside the
Here's an example of a generic
plugin-info block with this param:
Adding a Data Center-compatible add-on in the Marketplace
After you've tested and checked your add-on in clustered environments, you're ready to add a new version of your add-on to the Marketplace. A few things to keep in mind before you list your new version:
- Standard versions and Data Center-compatible versions of your add-on share a single Marketplace listing
This means if you have a standard add-on for JIRA or Confluence, the Data Center-compatible version will be on the same add-on details page. Just like if your add-on offers the same functionality for different hosting models (Cloud and Server), Data Center and standard Cloud or Server add-ons share the same listing page.
- Your add-on is demarcated with a Data Center icon to convey compatibility
Your Marketplace listing reflects if your add-on is Data Center compatible. If your descriptor declares the
atlassian-data-center-compatibleparam to be
true, your listing will show a Data Center icon:
Here's how to add a new Data Center version of your add-on:
- Log in to the Marketplace.
- Click Manage vendor account from the profile menu (upper right).
- Click the name of the add-on you're adding a Data Center-compatible version for.
Click Create version.
- Make any corresponding changes in release notes or branding assets.
- Save your new version.
If your add-on has already been approved, Data Center versions don't prompt another approval.