Skip to main content
Skip table of contents

Use Jira Tickets to Drive Deployments

In this guide, you'll learn how to configure Jira Automation and Golive to manage and track deployments directly from Jira tickets.

This setup enables you to automate environment status updates and deployment actions in Golive based on transitions in Jira issues, improving release coordination and visibility across your organization.


Understand the Solution

Numerous organizations use Jira tickets to manage and track their deployment requests. This approach is particularly effective when coordinating with multiple stakeholders for requesting, approving, and executing application deployments to different environments.

By combining Jira Automation with Golive, you can automate how Environment Statuses and deployments are updated — directly from Jira transitions.


Requirements

  • Golive Cloud installed on Jira Cloud.

  • A Jira project where deployment requests will be managed.

  • Admin permissions to create issue types, workflows, and automation rules.

Info

This configuration has been tested on Jira Cloud, but it should also work on Jira Data Center.


Configuration Overview

You will need to create:

  • One custom Work Type called “Deployment Request”

  • A dedicated Workflow for deployment tracking

  • Four Jira Automation Rules:

    • In Progress (updates Target Environment to “Deploy”)

    • Successful Deployment (creates deployment and marks issues as deployed)

    • Failed Deployment (updates Target Environment to “Down”)

    • Cancellation (rolls back a previously created deployment)

Work Type

A dedicated work type called “Deployment Request” is used to track all deployments to Test and Production environments. Several fields are defined:

  • Deployed Version: A single value “Jira Version” custom field.

  • Target Environment: A single value Environment Custom Field.

  • Other optional fields, like the “Due date” in the screenshot below

Example of “Deployment Request” Screen

Workflow

A specific workflow is used to track deployment requests and it can be adapted to your needs:

Example of “Deployment Request” Workflow


Jira Automations

We are using 4 Jira Automation Rules:

  1. When the Request transitions from “In Review” to “In Progress”

    • The Target Environment status is updated to DEPLOY

  2. When the Request transitions from “In Progress” to “Done” (Deployment Successful)

    • The selected “Deployed Version” is deployed to the selected “Target Environment” in Golive

    • The Jira work items marked as ‘Done’ and fixed in the “Deployed Version” are automatically marked as deployed in Golive and Jira

    • The Target Environment status is updated to UP

  3. When the Request transitions from “In Progress” to “Canceled” (Deployment Failed)

    • The Target Environment status is updated to DOWN

  4. When the Request transitions from “Done” to “Canceled” (Cancel Deployment)

    • We rollback by deleting the deployment in Golive and in the Jira issues that were marked as deployed


Configuration Steps

Step 1: Create the “Deployment Request” Work Type

If you are using a company-managed Jira Project, the following steps should be performed by a Jira Admin:

  1. Create a new Work Type called Deployment Request.

  2. Add the following fields:

    1. Deployed Version: A single value “Jira Version” custom field.

    2. Target Environment: A single value Environment Custom Field.

  3. Create your Workflow and assign it to your “Deployment Request”.

If you are using a team-managed Jira Project, you just need to be Project Admin in order to create this new “Deployment Request” issue type and define a workflow.

Step 2: Create the “Deployment Request – In Progress” Automation Rule

This rule updates the Target Environment status to DEPLOY when the request transitions from “In Review” to “In Progress.”

image-20260330-145241.png

Deployment Request - In Progress

1. Trigger

When issue transitions from In ReviewIn Progress. You can also specify additional criteria to be met e.g. work type.

image-20260330-145058.png

Work item transitioned

2. Send web request (update Target Environment status)

image-20260330-152317.png

Send web request

Web request URL:

CODE
https://golive.apwide.net/api/status-change?environmentId={{issue.Target Environment}}

api-key” header: paste the previously generated Golive API Token

Custom data:

Important

Make sure the status exists in your configuration.

CODE
{
  "name": "Deploy"
}

Step 3: Create the “Deployment Request – Successful” Automation Rule

This rule runs when a deployment request transitions from In Progress to Done (Deployment Successful).

It performs the following actions:

  • Deploys the selected Deployed Version to the Target Environment in Golive.

  • Marks related Jira issues as deployed in both Golive and Jira.

  • Updates the Target Environment status to UP.

image-20260330-153002.png

Deployment Request - Successful

1. Trigger

When issue transitions from In ProgressDone. You can also specify additional criteria to be met e.g. work type.

image-20260330-153611.png

Work item transition as trigger

2. Lookup Work Items

image-20260330-153839.png

Lookup work items

JQL:

CODE
fixVersion in ({{issue.Deployed Version}}) and StatusCategory = Done

3. Create Variable

image-20260330-153937.png

Create variable

Variable name:

CODE
Issues

Smart value:

CODE
{{lookupIssues.key.asJsonStringArray}}

4. Log Action

image-20260330-154043.png

Log action

Log message:

CODE
Issues: {{Issues}}

5. Send Web Request: Update Deployment of Target Environment

image-20260330-154443.png

Send web request

Web request URL:

CODE
https://golive.apwide.net/api/deployment?environmentId={{issue.Target Environments}}

Custom data:

JSON
{
  "versionName": "{{issue.Deployed Version.name}}",
  "issueKeys" : {{Issues}}
}

“api-key” header: Paste the previously generated Golive API Token

6. Create Variable

image-20260330-160838.png

Create variable

Variable name:

CODE
DeployID

Smart value:

CODE
{{webResponses.last.body.deploymentId}}

7. Log Action

image-20260330-160955.png

Log action

Log message:

CODE
Deployment ID: {{DeployID}}

8. Set Entity Property

We are storing the deployment ID with the Jira issue, in order to delete it in case of a future cancellation.

image-20260330-161054.png

Set entity property

Entity type:

CODE
Issue

Property key:

CODE
GoliveDeploymentID

Property value:

CODE
{{DeployID}}

9. Send Web Request: Update Target Environment Status

image-20260330-155154.png

Send web request

Web request URL:

CODE
https://golive.apwide.net/api/status-change?environmentId={{issue.Target Environments}}

“api-key” header: Paste the previously generated Golive API Token

Custom data:

Important

Make sure the status exists in your configuration.

CODE
{
  "name": "Operational"
}

Step 4: Create the “Deployment Request – Failed” Automation Rule

This rule updates the Target Environment status to Down when the deployment request transitions from In Progress to Canceled.

image-20260330-155655.png

Deployment Request - Failed

1. Trigger

When issue transitions from In ProgressCanceled. You can also specify additional criteria to be met e.g. work type.

image-20260330-155731.png

Work item transition as trigger

2. Send Web Request: Update Target Environment Status

image-20260330-160315.png

Send web request

Web request URL:

CODE
https://golive.apwide.net/api/status-change?environmentId={{issue.Target Environments}}

“api-key” header: paste the previously generated Golive API Token

Custom data:

Important

Make sure the status exists in your configuration.

CODE
{
  "name": "Down"
}

Step 5: Create the “Deployment Request – Cancellation” Automation Rule

This rule rolls back a previously created deployment when the request transitions from Done to Canceled.

It performs the following actions:

  • Deletes the deployment in Golive and Jira.

  • Updates the Target Environment status to Down.

image-20260330-161633.png

Deployment Request - Cancellation

1. Trigger

  • When issue transitions from DoneCanceled. You can also specify additional criteria to be met e.g. work type.

image-20260330-161735.png

Work item transition as trigger

2. Create Variable

image-20260330-161857.png

Create variable

Variable name:

CODE
DeployID

Smart value:

CODE
{{issue.properties.GoliveDeploymentID}}

3. Log Action

image-20260330-162011.png

Log action

Log message:

CODE
Deployment ID: {{DeployID}}

4. Send Web Request: Delete the Deployment to Rollback

image-20260330-162135.png

Send web request

Web request URL:

CODE
https://golive.apwide.net/api/deployment/{{DeployID}}

“api-key” header: paste the previously generated Golive API Token


Need Assistance?

For support with integrating Golive and Jira Automation, reach out to our Customer Portal.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.