Last updated Mar 27, 2024

Plugin release checklist

Each time you release a new version of a plugin, there are certain steps you should perform.

Creating the release

  1. Make sure your plugin's pom.xml is up-to-date. This includes accurate sections for:
    • Parent POM -- Make sure that the plugin is using the correct parent POM for the product and the most recent version of it.
    • version -- It should be <version_to_be_released>-SNAPSHOT.
    • scm -- Source control repository locations.
    • atlassian.product.version
    • atlassian.product.data.version
  2. Run mvn release:prepare -- This will update your pom.xml release numbers and make a new tag for the release.
  3. Run mvn release:perform -- This will:
    1. Run tests
    2. Compiles code and package it
    3. Put the binary package in an appropriate Atlassian Maven Repository and your local Maven repository.
  4. Copy the created binary package from your target sub-directory to the project's jars sub-directory (in SVN). Then schedule it for addition to SVN before finally committing the added resource.

Updating the plugin's project

#You'll need to release the current version of the project in JIRA and move any unfinished issues for the project to a later version. Here's how:

    1. Go to the project page in JIRA.
    2. Click on Administer Project.
    3. Under Versions, click on Manage versions.
    4. From this screen, choose "release" for the version that you just created. Make sure the date is correct, and move any remaining open issues to the next unreleased version.
  1. Update plugins documentation on on studio.plugins.atlassian.com/wiki/.

  2. Update the plugin's listing on plugins.atlassian.com

  3. Communicate about release (probably with a blog post and a post to the appropriate mailing list.)

Rate this page: