Jira Approvals

Updated 2 months ago by Archana Singh

You can use Jira to approve or reject a Workflow or Pipeline step.

In your Harness Workflow or Pipeline, you define a Jira ticket and approval and rejection criteria. During deployment, a Jira ticket is created and its approval/rejection determines if the Pipeline (and Workflow) deployment may proceed. For details on integrating Jira with Harness, see Jira Integration.

The other approval mechanisms are:

Before You Begin

Step: Add an Approval Step

  1. In your Pipeline, in Pipeline Stages, click +. The following settings appear.
  2. Select Approval Step.
  3. Select Jira in the Ticketing System.
  4. Select the Jira account in Jira Connector that you want to use by selecting the Collaboration Provider you added for the account. For more information, see Add Jira Collaboration Provider.
  5. Select the Jira Project containing the Jira issue you want to use for approval.
  6. Enter the Key/Issue ID. It is the output variable for a Jira issue created in a Workflow, for example ${Jiravar.issueId}. You can enter the Jira Key/Issue ID for any Jira issue in the Jira project.
  7. Enter the time duration in Timeout that Harness should wait for the approval or rejection before failing the deployment. You can use w  for week, d  for day, h  for hour, m  for minutes, s  for seconds and ms for milliseconds. For example, 1d for one day.
  8. Define the Approved Status Criteria using the Jira status items.
  9. Define the Rejected Status Criteria using the Jira status items.
  10. Select Execute in Parallel with Previous Step checkbox to execute the steps in parallel.
  11. Select either Do not skip or Skip always for setting the skip option. For more information, see Skip Execution.
  12. Click Submit.
  13. Deploy your Pipeline and go to the Deployments page. The Approval Stage displays the following information:
  • Message: The "Message" appears only when the stage of a Pipeline is completed, and there is no action pending from the user or system. It displays the completed status of the process. For example, approval provided, approval rejected, or Pipeline aborted.
  • Started At: The time at which the Pipeline was triggered.
  • Ended At: The time at which the system or a user completed the approval process.
  • Issue URL: Link to the Jira issue.
  • Timeout: The time duration that Harness should wait for the approval or rejection before killing the deployment process.
  • Triggered By: The user who triggered the Pipeline deployment. It can be triggered using a Pipeline or Trigger process.
  • Approval Criteria: Criterion set for approving the request.
  • Current Value: Current status of Jira issue.
  • Rejection Criteria: Criterion set for rejecting the request.

You can click on the Issue URL link to see the Jira issue in Jira's UI and select set approval or rejection criteria. In this example, the status Done fulfills the Approval Criteria.

Once the Jira issue is approved, the Approval stage turns green in Deployments, and the deployment continues.


How did we do?