Getting started with Digital.ai Release

Digital.ai Release is an end-to-end pipeline orchestrator for DevOps and continuous delivery. It provides visibility across the entire software release pipeline and assists in automating and orchestrating release operations.

Key Concepts

Here are some of the key concepts for Release:

• Releases: A release represents a number of activities in a certain time period. Release is used to plan, track, and execute releases automatically. For more information, see Release life cycle.
• Phases: A release is divided into phases, which represents logical stages in the process that must happen in succession. For example, a release can include Development, QA, and Deployment phases. In Release, a phase is a grouping of tasks, that must be completed to perform the release. For more information, see Working with phases.
• Tasks: A task is an activity in a release, and are of two types: manual tasks, in which a human must do something; and automated tasks that the Release flow engine performs. For more information, see Working with tasks.
• Release flow: When a release is started, the release flow engine determines what task is next in line and executes it, if it is an automated task. Otherwise, sends a message to the person responsible for it, if it is a manual task. For more information, see Using the release flow editor.
• Release owner: A release owner is the person who is responsible for a release. If something goes wrong, the release owner will be notified. For example, if an automated task throws an error or someone working on a task indicates that there is an issue.
• Template: A template is a blueprint for a release. You can use a template to save time when putting together releases that are similar. For more information, see Create a release template.
• Teams: Each release or release template defines a set of teams. For example, you can define a Development team, a QA team, an OPS team, and a Release Management team for a release.
• Workflows: With Digital.ai Release 23.3, we are bringing in new self-service workflows so that Developers can onboard their applications easier with minimum knowledge of tools. Newly introduced workflows guide users through step-by-step execution of tasks, reducing complexity in setting up environments. For more information, see Workflows.
• Cloud Connectors: A Cloud Connector is an agent that handles the installation and management of various components like Remote Runner and Data Collector (for intelligence) in the customer environment. It is particularly useful when customers use multiple Digital.ai products or the Digital.ai Platform.

Accessing Digital.ai Release

1. Enter the URL of the Release instance in your browser.
2. In the User field, enter your username.
3. In the Password field, enter your password.
4. Click Log in.

note

This system is for authorized users only. All the failed logins are logged and reported as security incidents.

note

If you want to remember your username and password on the machine, select the Keep me logged in checkbox.

Exploring Digital.ai Release

Get started by exploring the Release user interface:

1. In the left navigation pane, click Tasks.
2. To follow a guided tour of the main features of Release, click the Welcome! Click me to get started task.

note

If you do not want new users to receive this task, delete the Welcome to Release template from the Samples & Tutorials folder.

Modeling Release Pipelines

This section describes how to configure and run a basic release pipeline.

Creating Templates

In Digital.ai Release, a release pipeline is modeled as a template. To release your software, a release must be created based on the template. This ensures that each release follows a consistent procedure. To create a template:

1. In the left navigation pane, under CONFIGURATION group, click Templates.
2. Click New template > Create new template.
3. In the Create template page, enter a name in the Template name field.
4. Click Create.

Adding Phases and Tasks

In a template, phases are represented as columns, and tasks are represented as boxes within each column. In a running release, phases are executed from left to right, and tasks are executed from top to bottom.

Add a new phase and populate it with tasks:

1. On the top-right corner, click Add Phase.
2. In the phase header, click New Phase, and enter a name for the phase.
3. Hover-over the right side of the phase header, click , and select a color from the dropdown.
4. In the phase body, click Add task.
5. In the Task title field, enter a name for the task.

note

This tutorial uses a manual task type. For more information on task types, see Types of tasks in Release.Task types can be changed at any point before a release starts. For more information, see Change a task type.

6. Repeat steps 4 and 5 to add more tasks.

Understanding Release Editor View States

Four views states are available in the Release editor. This section will help you to get familiar with them.

Flow View

The Flow view shows the phases and tasks in a release. Use this view to add, move, edit, and delete items.

To open the Flow view, from top of the Release flow editor, click on .

Table View

The Release table view provides an alternative view of a template or release that is optimized for working with tasks. For more information, see Using the table view.

To open the Table view, click .

Planner View

The Release planner view is an interactive Gantt chart that is used to view and edit the timing of the phases and tasks in a release or template. For more information, see Using the release planner.

To open the Planner view, click .

Code View

This view is available only for templates. The Releasefile view provides the current template in a releasefile format, it can also be exported from here. For more information, see Using the Releasefile view.

To open the Releasefile view, click .

Performing a Dry Run

This procedure is a continuation from Add phases and tasks. To perform a dry run of a release:

1. Click New release.
2. In the Release name field, enter a release name.
3. Click Create to create the release. The release is now in the Planned state.
4. Click Start Release.
5. Confirm that you are ready to start by clicking Start.
6. Click the first task in the first phase.
7. From the pop-up window, click Complete.
8. Click OK.
9. Select Release dashboard from the left navigation pane. This dashboard provides an overview and data on a release. For more information, see Using the release dashboard.
10. Select Release flow from the left navigation bar.
11. Click the next task.
12. Skip the task by clicking Skip. When you skip a task, you must enter a comment to proceed with the release.
13. Enter a comment and click OK.
14. Click the next task.
15. Click Fail. When you fail a task, you must enter a comment to proceed with the release.
16. Click OK. A failed task puts the release into a Failed state. You can resume the release by either restarting or skipping the failed task.
17. Skip the failed task, by clicking the task, and then clicking Skip.
18. Continue to complete all tasks until the release is completed.

Configuring Team on your Templates

In addition to global security, each template and release has its own permissions that you can assign to teams. A team is made up of roles and/or individual users.

To add a team to a template:

1. From the navigation pane, click Templates under Configuration group.

2. Click Test template, which is the template you created in Model a release pipeline.

3. From the navigation pane, select Teams & Permissions. By default, there are two teams on a template: the Release Admin, and the Template Owner team.

4. In the Teams section, in the Release Admin row, add Administrators under the Users column.

5. In the Template Owner row, add Administrators under the Users column.

   A release template has two permissions types, template-level - which relates to a template and, Release-level - which relates to a release.

6. In the Template permissions section, assign the actions and teams as follows:

• Template permissions
  • Template Owner: Create Release, View Template, Edit Template, Edit security
  • Release Admin: View Template
• Release permissions
  • Template Owner: None
  • Release Admin: View Release, Edit Release, Edit Security, Start Release, Abort Release, Edit Task, Reassign Task

Check out Reports

Digital.ai Release has a variety of built-in reports that helps you analyze your level of release automation and identify bottlenecks in your release processes.

To view reports:

1. From the navigation pane, under Reports group, click Dashboards.