Packages help you organize and manage complex modular product releases.
Particularly packages are useful when your product release is a combination of releases of its modules/components.
You can create a package, add multiple project versions into it and then track its release status on a higher level.
Microservices
Product and library releases
Product family releases
Client-based product releases
Each Jira project has its own list of packages which are managed on the Packages project tab.
There are some useful toolbar actions to work with packages easier and faster:
You can create a new package using Create package action on the toolbar.
Packages have the same properties as project versions:
In addition to that package can include none, one or many project versions which can be added to package on Create package screen.
You can perform the following actions with existing packages from the context menu:
Editing package works absolutely the same way as creating it. You can update all its properties and add/remove versions.
When you click Delete package action the confirmation dialog is displayed:
Versions are not deleted during this action. |
Packages can be released/unreleased similar to versions. Package release status is displayed in the packages list Status column.
You can filter packages by release status using filter options in the toolbar.
Packages can be archived/unarchived similar to versions. Package archive status is displayed in the packages list Status column.
You can filter packages by archive status using filter options in the toolbar.
Package issues are issues of all versions included in the package.
While only a limited number of issues and issue fields are displayed you can open all issues in Issue Navigator.
You can create, edit, delete project versions right on the Packages project tab without switching to the Releases tab.
Particularly you can:
You can create a new version using Create version action on the toolbar.
You can specify the following version details:
In addition to that version can be added to none, one or many packages using Packages field.
Edit version
Editing version works absolutely the same way as creating it. You can update all its properties and manage packages.
Versions can be released/unreleased similar to packages. Version release status is displayed in the packages list Status column.
Versions can be archived/unarchived similar to packages. Version archive status is displayed in the packages list Status column.
Remove version action is a quick way to remove the version from a particular package.
The removed version is neither removed from other packages nor deleted from Jira project.
Deleting version results in deleting version from Jira and from all packages.
A confirmation dialog is displayed to protect from accidential deletion.
You can view all issues of version. While only a limited number of issues and issue fields are displayed you can open all issues in Issue Navigator.
When you browse issue details you can easily find which packages the issue is part of based on its versions. The information about packages is located in Packages issue panel on the right side of the issue page.
Packages extension introduces new JQL function packageVersions() using which you can find issues in packages.
packageVersions() function's result are versions of a found package. That's why you need to use the function in version field context.
JQL search clause with packageVersions() example:
fixVersion in packageVersions("SUB","Product B v2.1") |
packageVersions() JQL can be used with any version field: fixVersion, affectVersion, custom version fields |
packageVersions() accepts two parameters:
The search result of the above query are issues which have versions in the fixVersion field:
On this page: