What is the deployments feature?
The deployments feature provides a timeline view of your deployment information in Jira when you connect a deployment tool like Bitbucket, GitHub, GitLab, Jenkins, Azure DevOps, or any other supported tool. This allows everyone on the team to track work items as they move through the deployment pipeline and see which features have deployed to which environment.
To use the deployments feature, you must enable deployments in your Jira project settings and connect a deployment tool to your Jira site. More about setting up your deployment integration.
Enable or disable the deployments feature
You must be a project admin to enable and disable features on a project. You must also have the permission View Development Tools to enable the deployments feature.
To enable or disable the deployments feature:
Navigate to your software project.
Next to your project's name in the sidebar, select More actions (•••), then Project settings.
Select Deployments.
Enable or disable the Deployments feature.
Another way you can enable deployments is by:
Select Add to navigation (+).
Select Deployments, then Add to navigation.
The Deployments feature will now be accessible from your project navigation.
To disable the deployments feature for your project is by:
Navigate to your software project.
In the Deployments tab, select More actions (•••), then Remove.
The Deployments feature will now be removed from your project navigation and disabled for your project.
Connect your deployment tool to Jira
To send deployment information to Jira, you must connect a development tool like Bitbucket, GitHub, GitLab, Jenkins, Azure DevOps, or any of the tools available on the Atlassian Marketplace. Your team must then reference work item keys in commits, branch names, and pull requests, to start linking code and deployment information to Jira. Read more about setting up your deployment integration and referencing work items in your development work.
View deployment information in Jira
Once you set up a deployment integration, the Deployments page will show all the deployments linked to your work items, displayed over a timescale. You can filter by environment, version, epic, and work type, or change the date range.
As well as tracking the status of work, the Deployments page also tracks your team’s performance. The deployment frequency insight tells you how often your team deploys to production, and tracks your team’s average weekly deployments over a 12-week range. The cycle time insight measures how long it takes your team to ship work items through the deployment pipeline, from the first commit until the code is deployed to production. It shows your median cycle time per week, and calculates your overall median from the last 12 weeks. More about deployment insights.
Outside the Deployments page, Jira will also show deployment information in the following places:
On Jira work items - the development panel updates automatically to show deployment status and environment details.
Your Jira board - displays an icon when a deployment is linked to a work item. Hover over the icon to view the details of the deployment.
In the Releases hub - if you’re using releases and versions to organize your work in Jira, the releases feature shows deployment information for all the work items in your version.
In JQL - search your project for deployment information using JQL (for example, search for all the work items that have been deployed to production). View more about JQL.
In automations - set up automation rules to perform certain actions based on the deployment data linked to your work items (for example, send a slack message when a work item is deployed to production). More about DevOps automation triggers.
Was this helpful?