10X: Create a Release Vehicle for an Actual Release to Market

A release vehicle represents an actual release to market or to internal end users of software. There is a link to the release vehicles page from the PI’s page (Program Increment page > Manage Release Vehicles link next to Release Vehicles) so that a release train engineer can see everything related to the release in one place. Clicking Manage Release Vehicles opens the page with release vehicles associated with that release.

Release vehicles are sorted by date with the newest at the top of the grid. All release vehicles associated with the same release are grouped together.

On the Release Vehicles page, you can use a filter option to narrow down the list of selected criteria displayed in a grid. For example, you may want to filter the list of release vehicles by an ID, a name, a release, an owner, by dates, status, health, type, and other. Additionally, you can click a column header to sort the list.

You can view an audit log on the Release Vehicles page to look at all changes that happened to the release vehicle and the name of the person who made the changes.

Note: You can view the identification, capitalized, and operating codes the release vehicle is associated with through the Time Projects page. The codes are read-only. The codes that are active and currently open against the release vehicle are marked with the Active phrase. Here, you can also click the release vehicle name to view the code details in a new window. To add a new work code to the release vehicle, click the Add Work Code To Release Vehicle link. The link is not available for the complete release vehicles.

Go Live date

When the release vehicle’s status is set to Launched, the Go Live date is automatically set for today's date. The Go Live date cannot be set before the Start date.

If the Launched status is changed to any status other than Closed or Archive, the Go Live date is cleared.

Closed/Cancelled date

When the release vehicle’s status is set to Closed or Cancelled, the Closed/Cancelled date becomes a required field and is automatically set for today’s date. You can edit it if necessary. The Closed/Cancelled date cannot be set before the Go Live date. The Closed/Cancelled date is grayed out and cannot be edited if the release vehicle’s status is not Closed or Cancelled.

If the Closed or Cancelled status is changed to any other status, the Closed/Cancelled date is cleared. 

Creating Release Vehicles

To create a release vehicle:

  1. Select Program from the left menu bar.
  2. Under the Program section, select Program Increments; the Program Increments page displays.
  3. From the More Actions menu on the toolbar, select Release Vehicles.
  4. On the toolbar (top-right of the page), click the Add Release Vehicle button.
  5. In the Name box, type the name of the release vehicle.
  6. Select the status and health of the release vehicle from the corresponding drop-down menus. The choices for the Health option depend on the status you select. When you select a status, you can see the following Health options:
    • Planning: At Risk, On Track, and On Hold
    • In Progress: At Risk, Critical / Slip, On Track, and On Hold
    • Launched: At Risk, Critical / Slip, On Track, and On Hold
    • Closed: Complete
    • Cancelled: Complete
    • Archive: Complete
  7. From the Type drop-down menu, select the scope of the release vehicle. The available options are major, minor, and support.
  8. Select the Start and Ship dates of the release vehicle.
  9. From the Owner drop-down menu, select the owner of the release vehicle. By default, it is a name of the person creating the release vehicle.
  10. From the Program Increment Shipped In drop-down menu, select the release the release vehicle is associated with.
  11. Select the product you want to associate with this release vehicle for financial reporting services. Only products with the Active state appear here.
  12. Select one or more programs which contribute to this release vehicle.
  13. Select one or more teams which contribute to this release vehicle. You can choose from all teams accessible to you. This field is used so that teams can be tied to tasks on the projects they are assigned to.
  14. If in Step 10 you selected a PI that belongs to any programs that are mapped to a Jira project under Jira Settings and want to synchronize this release vehicle with Jira: 
    • Select the Jira project that is associated with this release vehicle from the Jira Project drop-down menu. The list includes all Jira projects that the parent PI’s program is mapped to under Jira Settings under Administration. You will see the [Jira Project Key] name added after the release vehicle name to understand what project is working in scope of this release vehicle.
  15. Click Save. Additional fields appear: Go Live Date and Closed/Cancelled Date.

Notes:

  • There is also a link to the Release Vehicles page from the release’s page (Program Increment page > Manage Release Vehicles link next to Release Vehicles).
  • You can edit the default Type options under Administration > Settings > Platform > Dropdowns.
  • You can rename the terms Start DateShip DateGo Live Date, and Closed/Cancelled Date so that they match your organization processes. You can rename the terms under Administration > Settings > Platform Terminology.
  • Use the External References option on the right side of the page to add a design, compliance, approval, or other types of links to the external source. This option may be useful when linking to information specific to the release vehicle that is necessary for the external auditors who review the application releases for compliance purposes.

Click Release Vehicle Hierarchy on the right side of the slide-out panel to view the hierarchy of release vehicles in the following order:

  • The name of the PI the release vehicle is associated with.
  • All release vehicles sorted by the Ship date from latest to oldest.

Note: After you created a release vehicle, you can delete it by clicking the Delete button. However, if you associate a release vehicle with a work code, you cannot delete it, but you can deactivate it. You must set the release vehicle to the Complete health state to deactivate it. 

Important: Tying Release Vehicles to Features

Important: For release vehicles to function properly within Jira Align, and specifically roadmap functionality, you must assign them to each individual feature that is to be included in the release vehicle. That is, access each feature that you want to include in the release vehicle, and add the release vehicle to the feature via the Release Vehicle field of the feature's slide-out panel. If the release vehicle does not display on the feature's slide-out panel, contact your Jira Align administrator who can add it via Details Panels Settings.

Was this article helpful?
1 out of 1 found this helpful
Print Friendly Version of this pagePrint Get a PDF version of this webpagePDF

Join the Atlassian Community!

The Atlassian Community is a unique, highly collaborative space where customers and Atlassians come together. Ask questions and get answers, start discussions, and collaborate with thousands of other Jira Align customers. Visit the Jira Align Community Collection today.

Need to contact Jira Align Support? Please open a support request.