Installation

Installing the dependencies

You need to install 3 separate apps to implement the complete automation mechanism. Each app can be conveniently installed through the Universal Plugin Manager (UPM). The whole procedure requires only some clicks and some minutes of your time.

Because of their dependencies, install the apps in this order:

  1. Install the Better Commit Policy for Jira app. This app provides the core Version Control System integration and the DevOps event multi-casting functionality.
    See the installation guide.
  2. Install the Automation for Jira app. This app provides the automation framework.
    See the installation guide.
    Important: Automation for Jira Lite, the free version of the automation framework, is not sufficient because it does not support third party triggers.
  3. Install the Better DevOps Automation for Jira app. This app "sits between" the commit policy app and the automation framework, and makes DevOps events available for automation rules.
    See the installation guide.

If you faced an "app cannot be initialized" problem during the installation, just continue installing all the 3 apps, then restart Jira and enable the disabled ones of these apps in the above order.

Version compatibility between dependencies

As the automation mechanism is composed of Jira plus 3 apps, each with its own versioning, the following table defines the recommended combinations. Please note that the table shows version ranges (not specific versions). It aims to avoid wasting time with unsupported combinations.

Jira Data Center Automation app Better DevOps Automation for Jira Better Commit Policy for Jira
7.7.0 or newer7.2.4 or newer1.0.0 or newer5.0.0 or newer

For Bitbucket users: on the Bitbucket-side you need to use Better Commit Policy for Bitbucket version 5.0.0 or newer. Prior versions don't support DevOps automations.

Version compatibility when installing dependencies directly from Atlassian Marketplace

The golden rule of thumb: install the app version that is offered by the Universal Plugin Manager (UPM)!

Version compatibility when installing dependencies by uploading the app JARs

In case you install an app by uploading it to Jira, then check out its "Version History" page at Atlassian Marketplace. That will show the compatible Jira versions for each app version:

  1. Automation for Jira version history
  2. Better DevOps Automation for Jira version history
  3. Better Commit Policy for Jira version history

In this case the golden rule of thumb: install the newest app version that is compatible with your Jira version!

Installing the app

You can easily install the Better DevOps Automation for Jira Data Center app using the Universal Plugin Manager (UPM) that is built into Jira.

Although you can install it in two different ways, we highly recommend the first approach for your convenience. You should use the second approach only if the server that hosts your Jira instance has no access to the Atlassian Marketplace, i.e. when the direct communication between those is not possible.

Installing directly from Atlassian Marketplace
  1. Login to Jira as administrator, go to Jira AdministrationAdd-onsFind new add-ons and search for the term "better devops automation".
  2. Click Install at the entry of "Better DevOps Automation for Jira" in the search results.
  3. Click Manage add-ons in the left and check whether "Better DevOps Automation for Jira" is visible in the User-installed add-ons list, and whether it is enabled.
Installing by uploading the app JAR
  1. Download the app JAR from its version history page at Atlassian Marketplace. Make sure that you download the app version which is marked compatible with your Jira Data Center version.
  2. Login to Jira as administrator, go to Jira AdministrationAdd-onsManage add-ons and click Upload add-on in the right.
  3. Click Browse, select the better-devops-automation-for-jira-x.y.z.jar that you just downloaded, and upload it.
  4. Check whether "Better DevOps Automation for Jira" is visible in the User-installed add-ons list, and whether it is enabled.