• Products
  • Get started
  • Documentation
  • Resources

Set up deployment gating

The features described in this article are available for service desk projects using the early access IT service management template. Learn how to access the new ITSM template.

Deployment gating lets you allow or prevent deployments at specific points in the change management process using a CI/CD tool that you’ve connected to Jira Service Desk.

To use deployment gating, you’ll need to set it up in Jira Service Desk, and then set it up in your CI/CD tool.

Before you begin

Set up deployment gating in Jira Service Desk

  1. From your service desk project, go to Project settings > Change management.

  2. Under Deployment gating, select Allow or prevent deployments using statuses in the change request workflow.

  3. Under Allow deployment, select a status to transition to when the deployment is allowed.

    • If you’re using the default change management workflow, we recommend selecting Implementing.

  4. Under Prevent deployment, select a status to transition to when the deployment is prevented.

    • If you’re using the default change management workflow, we recommend selecting Declined.

  5. Select Save changes.

Jira Service Desk will send a message to the deployment provider when a deployment is allowed or prevented.


Set up deployment gating in your CI/CD tool

Bitbucket

To use deployment gating with Bitbucket, you’ll need to have a Standard or Premium Bitbucket license, be an admin for the repository for the service you want to connect, and set up deployment gating in Jira Service Desk following the instructions above.

To set up deployment gating with Bitbucket:

  1. From your service desk project, go to Project settings > Change management.

  2. Under Bitbucket pipelines, select Configure next to the service you want to use with deployment gating.

    • If you don’t see Bitbucket pipelines, set up deployment tracking.

    • If you see Bitbucket pipelines but you don’t see the service that you want to use, select Connect service and follow the prompts to connect your service.

  3. Select the environment that you want to gate deployments for.

  4. Turn on Enable deployment gating for this environment.

Jenkins

To use deployment gating with Jenkins, first set up deployment gating in Jira Service Desk following the instructions above, and then link Jira Service Desk with Jenkins.

Other CI/CD tools

Deployment gating for other CI/CD tools is coming soon. Check back here for updates.

 

Last modified on Sep 21, 2020
Cached at 10:18 PM on Oct 27, 2020 |

Additional Help

Ask the Community