Work with Delivery Insights Tasks

Note: In real world scenarios, you may have a CI tool (like Jenkins) to create a build. When it's done, you can use Digital.ai Release to start a new release, which in turn creates a package revision that you can track in your Progression Board. However, for illustrative purposes, we are going to create and run the following Create Package Revision task manually.

Create a Package Revision

1. Log in to Release.

2. Select Folders from the left navigation pane.

3. Click + Add folder and create a new Delivery Insights folder.

   

4. Select the Delivery Insights folder, select Templates from the left navigation pane, and click New template > Create new template.

   

5. Type a name for the template and click Create (Create Package).

   

6. Click Add Task.

7. Type a title for the task (Create Package Revision).

8. Select the Track new code commits task from the drop-down list.

9. Click Add. The Create Package Revision task is created.

   

10. Click the Create Package Revision task to configure it.

11. Click the Application field's search icon and select the application you created (Web Server).

    

12. Type the repository's branch name to fetch the commits from.

13. Click the Initial phase field and select the initial phase you want the package revision to be created in.

14. Type a version label, 23.1 for example.

15. Close the Create Package Revision task's configuration dialog box.

16. Click New Release.

17. Type a name for the release (Create 23.1 Package) and click Create.

    

18. Click Start Release.

    

19. A confirmation message appears. Click Start.

    

20. Click the completed task to view the log.

21. You can now go to the progression board and refresh the board to view the new package revision card.

    

22. Hover over a dot to view the associated work items. Note that, the dots look different here because the work items are split.

23. Click a dot to view the work item's details pane. You can click the Open in Jira icon to view the work item in Jira.

    Select the History tab of the work item details pane to view the history by phases and revisions (select the Phases and Revisions tabs respectively).

    

Promote a Package Revision

1. Select the Delivery Insights folder and click Add template > Create new template.

2. Type a name for the template and click Create (Promote Package).

3. Click Add Task.

4. Type a title for the task (Promote Package Revision).

5. Select the Promote revision task from the drop-down list.

6. Click Add.

   

7. Click the Promote Package Revision task to configure it.

8. Click the Application field and select the application you created (Web Server).

9. Click the Phase field's search icon and select the phase which you want the package revision to be promoted to.

10. Leave the other fields with the default values and close the Promote Package Revision task's configuration dialog box.

    

11. Click New Release.

12. Type a name for the release (Promote 23.1 Version 1), type a revision number you want to promote (1) in the revision text box, and click Create.

    

13. Click Start Release.

14. A confirmation message appears. Click Start.

    

15. Click the completed task to view the log.

16. You can now go to the progression board and refresh the board to view the new package promoted to the Test phase.

Remove a Package Revision

1. Select the Delivery Insights folder and click New template > Create new template.

2. Type a name for the template and click Create (Remove Package).

   

3. Click Add Task.

4. Type a title for the task. (Remove Package Revision)

5. Select the Remove revision task from the drop-down menu.

6. Click Add.

7. Click the Remove Package Revision task to configure it.

8. Click the Application field and select the application you created (Web Server).

9. Leave the other fields with the default values and close the Remove Package revision task's configuration dialog box.

   

10. Click New Release.

11. Type a name for the release (Remove 23.1 Revision 1), type the revision you want to deliver (1) in the revision text box, and click Create.

    

12. Click Start Release.

13. A confirmation message appears. Click Start.

    

14. Click the completed task to view the log.

15. You can now go to the progression board and refresh the board to confirm that the package revision has been removed (delivered) from the Progression Board.