Skip to main content

Linking tickets to deployments in Compare and Deploy

How to link Jira issues, Azure DevOps work items, or Asana tasks to a Compare and Deploy deployment, and what Gearset posts.

Written by Josh Camilleri

You can link Jira tickets, Azure DevOps work items and Asana Tasks to a deployment in Compare and Deploy. When the deployment completes, Gearset posts an update to each linked ticket.

Compare and Deploy currently supports Jira, Azure DevOps and Asana Tasks.

Connect your ticket system first. See Connecting a ticket system to Gearset.

How do I link tickets to a deployment?

On the Summary of items to deploy page, go to the Issue tracking section. As shown below:

Jira Issues

  1. In the Jira updates panel, select a project in Search all Jira projects.

  2. Select a ticket in Select a Jira ticket. You can search by title, description, or ticket reference, for example PROJ-123.

The ticket shows under Associated tickets.

When the deployment completes successfully, Gearset posts a comment on each linked ticket with details of what was deployed. Each team member's comments show under their own Jira account.

Azure DevOps Work Items

  1. In the Azure DevOps Work Items panel, select an organization in Search all organizations.

  2. Select a work item in Select a work item to update.

The work item shows under Associated work items.

Gearset currently supports work items in Azure DevOps Cloud organizations only.

Asana Tasks

  1. In the Asana panel, click on Select Asana Task to update

  2. You can search or select from the visible tasks.

Can I add the deployed items to the ticket?

Yes. Turn on one or both toggles in the panel:

  • Append validation items to ticket(s) adds the items from a validation.

  • Append deployment items to ticket(s) adds the items from a deployment.

Can I make my team link a ticket?

Yes. Turn on Require issue tracking in the Deployment settings on your My account page. Each Compare and Deploy deployment and pull request then needs a linked ticket.

Can I change what Gearset posts?

Yes. Click the cog icon on the panel for your ticket system.

In the deployment preferences window, turn each option on or off, then click OK.

Option

Jira

Azure DevOps

Asana

Include deployment notes in ticket comments

✓

✓

✓

Include source and target in ticket comments

✓

✓

✓

Only post comment to [ticket system] ticket when deployment succeeds

✓

✓

✗

Attach a deployment report to ticket when deployment succeeds

✓

✗

✗

Useful resources

Did this answer your question?