Digital.ai Release 24.3.x release notes
Support Policy
See Digital.ai Support Policy.
Upgrade Instructions
The Digital.ai Release upgrade process you use depends on the version from which you are upgrading, and the version to which you want to go.
For upgrade instructions, see:
Important: PostgreSQL is the recommended database for any fresh installation of Release 24.3 and later. Contact your Digital.ai representative if you prefer to use a database other than PostgreSQL for your new Release setup. For more information, see supported databases.
Breaking Changes
Here's a list of breaking changes in Release 24.3.
Activity Logs Messages
While updating the Activity Logs functionality for releases, templates, triggers, and deliveries, we have standardized the format of the activity text messages. It is not recommended to rely on the wording of these messages, as they may change in the future. Review your workflows to see if they depend on the message text and make any necessary updates.
Application Pipelines
The Application Pipelines feature has been superseded by Live Deployments. To learn more about what happens on upgrade of a site from Release 24.1 (or earlier) with Application Pipelines to Release 24.3, see Upgrade with Live Deployments.
End-of-life Notifications
Here's what is being deprecated or going out of support.
Template Versioning Updates
Release currently offers two methods for template versioning:
- Traditional template versioning
- GitOps-enabled versioning using YAML files
In our ongoing efforts to enhance Release, we have decided to prioritize the expansion of GitOps-enabled versioning using YAML files and will no longer enhance the traditional template versioning functionality.
The planned changes for Template versioning are as follows:
- Starting with the Release 24.3, template versioning and associated settings will be disabled for Release instances that do not currently utilize it. For more information, see Template Version Control.
- Existing customers with template versions stored in the database will not be impacted in any way.
The current template versioning has limitations due to its inability to read from Git repositories, which limits its usage to local server instances. This limitation blocks seamless collaboration and cross-instance sharing, thus hindering further expansion of this functionality. Therefore, we highly recommend you to consider upgrading to GitOps YAML-based versioning. This transition aligns with our commitment to security and interoperability, providing a more comprehensive and widely accepted solution for versioning and managing templates.
If you have any concerns or require further assistance, complete this survey or reach out to your Customer Success Manager or Digital.ai Support. Your feedback enables us to improve the product together.
Retiring the Task Modal
In line with our commitment to enhancing the user experience for managing tasks within Release, we are announcing a change in how tasks are handled.
The Release 24.3 is the final version that supports the Task Modal in the Release user interface. With 2025 versions, only the Task Drawer is available for creating and managing tasks. Transitioning to a single version (Task Drawer) allows for faster iterations and the introduction of new functionalities. Additionally, recent features added to the Task Drawer are incompatible with the older Task Modal.
To learn how to use the Task Drawer and explore its recent features, see:
Contact the Digital.ai Customer Success Manager or Digital.ai Support should you have any questions or concerns.
Live Deployments
Digital.ai Release 24.3 brings you Live Deployments. This feature enables you to track deployments from various sources and embed them in your release process. Previously, only deployments that were started from a task in the release process were known in Release. Now you can listen to deployment events from external tools like Digital.ai Deploy and ArgoCD and view live updates in Release. Now all deployment activity is on the same page, whether it comes from cloud-native Kubernetes environments or classic middleware. Additionally, you can make the external deployments part of the release flow, even when they are not orchestrated by Release.
- The Live Deployments dashboard helps you track "what is deployed where" and "what is the status of the deployed applications".
- Digital.ai Deploy and ArgoCD are supported. Support for other tools will be available in subsequent versions.
- Embed live deployment event in your release process using Webhook Event Triggers and the Webhook: Wait for Deployment Event task.
For more information, see Live Deployments in Release.
Applications and Environments in folders
Applications and Environments are now available at the folder level. Previously, they could only be defined at the global level. What's more, they are automatically created and updated for live deployments coming from Digital.ai Deploy and ArgoCD, saving a lot of manual housekeeping. The Applications and Environments feature is used for dashboards, audit reports and resource management in the environment calendar.
For more information, see:
Analytics
The Release 24.3 Premium edition brings you analytics that offer deeper insights and data visualization.
The Premium edition offers a comprehensive set of analytics dashboards, each tailored to specific user roles. These include:
-
DevOps Research and Assessment (DORA) Dashboard: DORA dashboard lets you analyze details to streamline or improve your DevOps process using key DORA metrics such as the deployment frequency, lead time for change, mean time to restore, and change failure rate. DORA metrics have now become the standard for gauging the efficacy of software development teams and can provide crucial insights into growth areas. For more information, see DORA Dashboards.
-
Workflow Adoption and Usage Patterns Dashboard: Lets you gain insights on team adoption of services and automation via Workflows. Identify what works best and manage your developer platform as a product. For more information, see Workflow Adoption and Usage Patterns Dashboards.
-
Persona-based Dashboards: These dashboards cater to specific personas such as the DevOps COE, Engineering Managers, Platform Engineers, Platform Product Managers, and Release Managers. For more information, see Overview of Analytics Dashboards.
-
Custom Dashboards and Data Sets: You can create custom dashboards with the most relevant data for your team and share them with others in your organization. Custom dashboards give you the flexibility to focus on a small dataset or a specific topic such as security.
Set Up Analytics
Configuring analytics for your installation involves a few steps such as connecting your Release instance to the Digital.ai Platform, configuring the data sources, setting up roles and permissions, and so on. Contact Digital.ai Support for assistance in setting up Analytics.
For more information, see Setting up Analytics.
When Connected to Analytics
When connected to the Analytics server, you can:
-
View the list of available dashboards in Release.
-
Manage dashboards—Analytics author users can manage dashboards. Click Manage Dashboard, go to the Digital.ai Platform, create and edit dashboards, which can then be published to Digital.ai Release for all users to see. For more information, see Manage Dashboards.
As an Analytics user, you can:
- Use filters to sort dashboards by category or author.
- Mark specific dashboards as favorites by clicking the star icon to add them to the Favorites tab.
- When you revisit the Analytics page, it takes you to the last visited tab. For example, if you were on the Favorites tab of the Analytics page, browse away to other pages in Release, and come back to the Analytics page, it will take you directly to the Favorites tab.
Workflow Enhancements
Task Groups in Workflows
We've added support for parallel and sequential group tasks in workflow templates. Task groups help combine related activities into a single action, making the execution flow easier to visualize and more intuitive for users to follow. For example, when running multiple scripts after each other, you can use a task group to hide these scripts from the main view and show a cleaner layout. You can even parallelize tasks to improve performance.
Note: In order to keep workflow execution straightforward and clean, workflow templates only support a single level of nesting.
Improvements to Workflow Execution Pages
We've done a number of improvements on how workflows are being displayed.
First of all, there is a redesigned infopanel on the left that has all essentials information about the currently running workflow in it. It has a progress tracker, main description and shortcuts to template and design view.
The progress sidebar on the right-hand side of the screen also got a makeover to make it easier to see where you are in the process and what you need to do.
Git Scan Workflow
CheckmarxOne Scan Git Repository Workflow: Run the CheckmarxOne Scan Git Repository workflow to scan your git repository, review scan results, and verify compliance from within the Digital.ai Release interface.
Release Plugin for Backstage
Release Templates in Backstage
Fo users of Backstage, we have released a plugin to integrate with Digital.ai Release. It allows you to see an overview of running releases and available templates, right in the Backstage UI. For more information, see Overview.
Navigation Updates
Release 24.3 brings you a revamped sidebar and menu navigation. Here's a few updates on navigation changes in Release 24.3.
Global and Folder Level Navigation
The Release sidebar has been revamped, both at the global and folder levels, for better navigation. We have made the order and grouping of navigation items more consistent. That means that some of the links can now be found in different places. We realize that these changes always take some getting used to, but we hope the grouping and consistency will make navigation easier in the end.
Here's the top level sidebar categories for easy navigation.
- The Overview section provides quick access to the building blocks of Release such as the folders, tasks, and workflow catalog.
- The Releases section includes links to access templates, releases, and related resources.
- The Deployments section groups deployments, applications, and environments.
- The Configuration section lets you access connections, triggers, and global variables.
- The Insights section lets you access analytics and reports.
Note: The default page when you select a folder is now Releases (previously it was Templates).
Release List and Calendar Tabs
The global Releases page has two new tabs—List and Calendar—to list all the releases and the release calendar respectively.
Navigating Into Subpages
When going into a section with subpages, we now use a pop up menu to select the landing page. This makes it easier to go directly to the desired page, rather than to go through a default landing page for that section.
Release Flow
We have cleaned up the Release flow view by moving much used elements to the sidebar on the left.
- The info section on top contains title, status, progress bar and link to the template it was created from. When on a template, it has a link to all releases created from it.
- The different views for Flow, Code, Table and Planner are now in the sidebar under the View section.
- Other items have been grouped and reordered for a more consistent navigation
For more information, see Release Flow Editor.
Move Folders
It's now possible to move folders. Use this feature to reorganize your folder tree, for example to reflect updates in your organization or for a more logical grouping.
You can now move folders that include templates, releases, triggers, connections, etcetera without conflicts, but some restrictions do apply. For example, if a template in a folder references a connection from another folder that is not available on the destination folder it will not be possible to move a folder.
For more information, see Move Folder.
Limitation:
- Folders containing releases and triggers that inherit configurations from other folders cannot be moved.
If parent folder connections are used and the current parent folder will no longer be the parent after the move: the move fails, and connections will need to be adjusted manually. Additionally, a folder cannot be moved into itself or any of its subfolder to prevent recursive structures.
Activity Log Makeover
The Activity Logs pages for releases, templates, workflows, delivery patterns, deliveries, and triggers have been updated with several enhancements.
UI Updates
-
By default, all activities are displayed with the most recent entries at the top, eliminating the need to manually select the Category filter.
-
Key actions are highlighted for easier identification, with an Important toggle that flags significant changes such as flagged tasks, deleted or skipped task, started phase, release or workflow, etc.
-
Color-coded tags (pills) help differentiate between completed, failed, and skipped items.
Quick Access
You can now directly navigate to tasks, releases, templates, and deliveries by clicking the links in the Target column.
Improved Search
- Search activities by ID (task, release, phase, template, etc.), user name, or activity message.
- Additional filters allow you to refine the search results. You can filter by activity type (e.g., failed or skipped tasks, changed release variables, etc.) and by user or system, with the option to select multiple values.
Changes in Activity Log Messages
- Message text has been updated. For more information, see here.
- Longer messages (including script tasks) display up to 1000 characters and are truncated if they exceed this limit. Both the old and new text are counted in the message length.
Accessing the Activity Log
-
You can access the Activity logs for a specific item from multiple locations. For example, Task Activity logs can be opened from the Release or Template Flow page task card or Task drawer context menus. Clicking this option leads to the Activity logs page, pre-filtered by the specific task ID.
Task Drawer Enhancements
The Task Drawer UI has been enhanced to improve the user experience.
Template Drop-down for Create Release task
In the Create Release tasks, the accessibility of searching and selecting templates from the Template drop-down has been enhanced. Previously, the drop-down only listed template names in a single, flat list. Now, templates are grouped under folders, making it easier to identify and select the appropriate template.
For more information, see Create Release task.
Documentation for Task Types
To access the documentation of the task type directly from the task, a new help icon button is added to the top header of the Task Drawer. This functionality is implemented across all tasks within Release, including those from plugins. For instance, upon accessing the Task Drawer of the Create Release task and clicking this help icon button, you will be directed to the corresponding documentation for the Create Release task.
Tip: Additionally, you can add links to your documentation site for custom plugins.
A new property called documentationPage
is added to the synthetic.xml
to define the documentation page link of the task.
Here's a sample:
<type-modification type="xlrelease.CreateReleaseTask">
<property name="documentationPage" required="false" hidden="true" default="how-to/create-a-create-release-task.html"/>