Quick Start Guide

This guide will help you startup the automation for Jenkins Integration for Jira.

Step 1: Install and Setup Jenkins Integration for Jira

In order for this automation extension add-on to properly function, you will also need to installed the Jenkins Integration for Jira add-on.

If you have installed this add-on, then continue on with step 2 of this guide,

Otherwise first follow the Quick Start Guide of the Jenkins Integration for Jira add-on before continuing with this guide.

Step 2: Installing the Jira add-on

The Jira add-on is published on the Atlassian Marketplace.

Installing the add-on directly for the Atlassian Marketplace

If you are connected to the Atlassian Marketplace website from your Jira's administration console, you can install apps by clicking the Install button from the Find new add-ons or Find new apps administration page.

  1. From the top navigation bar in Jira, choose Gear Icon > Manage apps.
  2. Entering "jenkins" or "jenkins automation" in the Search the Marketplace box. The "Jenkins Integration Automation for Jira" will be listed in the search results.
  3. Install the add-on by clicking on Install.
    A confirmation message appears when the app is successfully installed.

Step 3: Configure Automation Rules

After you installed the add-ons, you are ready to configure your first Rule.

  1. From the top navigation in Jira, choose Gear Icon > Manage Apps.

  2. Choose Jenkins Integration > Automation and click on the Add Rule button.
  3. This will take you to the new rule page where you can configure your first rule.
    Start by providing a meaningful name and optionally a description of the rule, having meaningful names and descriptions will help separate rules from one another when you have multiple.

  4. New you are all set to select the events the rule should be triggered on, any conditions that should be used to limit the scope of the actions, and of cause the actions that the rule should perform.

    Read up on the different elements that make up a rule in the Concepts section of the documentation.

    Take a look at the Common Use Cases section of the documentation for common rules that could be of interest.

Step 4: Enjoy Automation

Once you have rules setup you can see them in action through the rule logs.