Overview of Jira Integration

Overview

DevOps integrates with your team's Jira account to automatically update story statuses when you deploy a branch to an organization. This keeps Jira workflow statuses aligned with your release process. With the integration, you can control which organization deployments map to which Jira statuses and which stories relate to which branches.

How does the DevOps Jira Integration work?

To get started with the Jira Integration, connect your Jira account to DevOps. Once connected, add your Jira projects to the integration. Then configure Status Mappings to define which Jira status a story updates to when you deploy a branch to a specific organization. For example, map your Development organization to In Progress, your Testing organization to In Review, and your Production organization to Done. For instructions on completing these steps, see the following articles.

• Adding a Jira Integration

• Adding Projects to a Jira Integration

• Configuring a Jira Project

To control which stories update during deployment, add them to a branch's Related Stories list. When you deploy that branch, DevOps automatically updates all related Jira stories based on the Status Mapping for that organization, ensuring story statuses accurately reflect delivery progress without manual updates. For instructions on adding stories to a branch, see the following article.

• Adding Jira Stories to a Branch

Best Practices

• Use distinct names for integrations when connecting multiple Jira instances.

• Create separate status mappings for each environment (Dev, QA, Prod) to match your Jira workflow.

• Align Jira workflow statuses with your release process. For example: In Progress → In Review → Done.

• Save your configuration after every mapping change to ensure deployments trigger the correct updates.

Example Jira Integration

The diagram below illustrates how the Jira integration works using an example configuration and workflow. See the explanation of the Configuration and Workflow sections below.

• Configuration

  • Status Mapping

    • Dev org mapped to In Progress

    • Test org mapped to In Review

    • Prod org mapped to Done

  • Branch Related Stories

    • DO-1 Feature and DO-3 Bug2 stories are related to the NewVersion branch

  • Jira Project

    • Lists all stories in this example Jira project.

• Workflow

  • Shows what happens when the NewVersion branch is deployed to the Dev org.

  • Shows what happens when the NewVersion branch is deployed to the Test org.

  • Shows what happens when the NewVersion branch is deployed to the Prod org.