Skip to main content

Create Jira issues in CD stages

You can create a Jira issue as a step in the execution of a pipeline using the Create Jira step.

You can add the Create Jira step to a Harness CD stage or an approval stage.

You can also update Jira issues and add Jira approval stages and steps.

Before you begin​

  • Connect to Jira: You can add a Harness Jira connector before or during the Create Jira step setup.

Visual Summary​

The following video shows you how to use the Jira Create, Jira Update, and Jira Approval steps:

Limitations​

While it's not a strict limitation, some users can forget that when you use a Jira Create step it creates a new, independent Jira issue every time it is run (as opposed to updating the same issue).

It is important to remember that you should only add Jira Create to a stage if you want to create a new Jira issue on every run of the stage.

Add a Jira Create step​

  1. In a Harness CD or Approval stage, in Execution, select Add Step.
  2. Select Jira Create. The Jira Create step appears.

  1. In Name, enter a name that describes the step.
  2. In Timeout, enter how long you want Harness to try to create the issue before failing (and initiating the stage or step failure strategy).
  3. In Jira Connector, create or select the Jira connector to use.
  4. In Project, select a Jira project from the list. A Jira project is used to create the issue key and ID when the issue is created. The unique issue number is created automatically by Jira.
  5. In Issue Type, select a Jira issue type from the list of types in the Jira project you selected.

Add Issue fields​

In Jira fields, you can select specific fields within a Jira issue. For more information, go to Jira custom fields.

Harness supports only Jira fields of type Option, Array, Any, Number, Date, and String. Harness does not integrate with Jira fields that manage users, issue links, or attachments. This means that Jira fields like Assignee and Sprint are not accessible in Harness' Jira integration.

Jira Date field support​

Among the custom fields Harness supports are Baseline End Date and Start Date Time. If your Jira project uses these fields, they are available in fields:

Once you have selected these fields their settings appear.

You can also use advanced dates using Harness expressions and the current() function. For example:

  • <+currentDate().plusDays(2).plusMonths(1)>: current date plus one month and two days.
  • <+currentTime()>: for current date time fields.

Harness supports the following functions.

For date-only fields:

currentDate().plusYears(1).plusMonths(1).plusWeeks(1).plusDays(1)

For date and time fields:

currentTime().plusYears(1).plusMonths(1).plusWeeks(1).plusDays(1).plusHours(1).plusMinutes(1).plusSeconds(1).plusNanos(1)

The number 1 is used as an example. You can add whatever number you need.

Advanced settings​

In Advanced, you can use the following options:

Apply and test​

Select Apply Changes. The Jira Create step is added to the stage.

Run the pipeline.

In the pipeline execution view, select the Jira Create step, and then select the Output tab.

You can see all of the fields for the new Jira issue you created.

Locate URL and copy its value.

In a new browser tab, paste the URL and press enter.

The new issue appears in Jira.