Skip to content

Latest commit

 

History

History
60 lines (36 loc) · 4.47 KB

jira-integration.md

File metadata and controls

60 lines (36 loc) · 4.47 KB
description
Triage your flaky tests faster by creating automatically assigned and labeled tickets with the Jira integration

Jira Integration

When Trunk Flaky Tests detects a broken or flaky test, you can create an automatically generated ticket for your team to pick up and fix the test. Currently, Ticket Creation only supports integrations with Jira, but the automatically generated ticket content is formatted in Markdown and can be copied to other platforms like Asana, Linear, or GitHub issues.

Connecting to Jira

To connect a Jira Cloud project, navigate to Settings -> Repositories -> Jira Cloud. Then complete the form and click Connect to Jira Cloud with the following information.

Field NameDescriptionExamples
Jira URLThe URL to your Jira Cloud project.https://trunk-io.atlassian.net
Project KeyThe project key for your Jira project.KAN
EmailThe email associated with your Jira API token.[email protected]
Jira API tokenCreate your Jira API token here.ATATT*****19FNY5Q
Default label(s) for new ticketsLabels applied to new Jira tickets created through Trunk Flaky Testsflaky-test, debt

After connecting to Jira, you can specify a default issue type for new tickets and a default assignee for the new tickets.

Ticket Content

Trunk Flaky Tests automatically generates tickets complete with a title and description. If you’re connected to a project management software like Jira, there are further options to assign default labels or assignees.

The ticket description contains the following information:

  • Identifier of the test
  • Since when the test has been labeled flaky
  • The last time this test has failed
  • The impact when run on PRs
  • The impact when run on branches
  • Quarantine status
  • Most common failure reasons
  • Code owners according to the CODEOWNERS file in your repository

Create a New Ticket

You can create a new ticket for any test listed in Trunk Flaky Tests.

You can create a new ticket on the Flaky Test dashboard by clicking on the options menu for any test cases listed.

You can also find a Create ticket button in the top left corner of the test case details screen as well.

Before you create the ticket, you will have a preview of the title and description of the ticket.

Create with Jira

If you are connected to Jira, you can click the Create Jira Ticket button at the end of the modal, which will automatically create a ticket with the configured labels and assignees.

Create Manually

If you have not set up an integration, Trunk Flaky Tests will still generate a ticket title and description so you can copy and paste the details into your project management software.