Digital.ai Release 22.3.0

Digital.ai Release 22.3.0 includes the following new features:

• Application Deployments Dashboard—a new dashboard to view the live status of deployed applications
• Task Drawer—a new UI for task details
• Progressive delivery with Digital.ai Release—Argo Rollouts integration
• Release Maintenance Mode
• Restart Phase Failure Handler
• Display warning for entity deletion
• Live update of DB credentials
• Pendo for customer insights
• Version upgrades—supported databases
• Operator-based installer changes
• Plugins and integrations

And more bug fixes and enhancements.

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:

• Upgrade Release—on JVM.
• Upgrade Release—on Kubernetes

Digital.ai Release 22.3.0 New Features

Here's what's new with Digital.ai 22.3.0.

Live Status of Deployed Applications

With Digital.ai Release 22.3, you can visualize the live status of the applications deployed in Digital.ai Deploy and Argo CD. A new dashboard is provided to display the live status of the applications.

Live Status of Deployed Applications is a feature in Tech Preview—released in Digital.ai Release 22.3—enabled by default. You can disable this feature from the Feature flags section in System settings.

For more information, see View Live Status of Deployed Applications.

Live Status of Deployed Applications:

Task Drawer—a New UI for Task Details

• The Task Drawer UI replaces the Task Modal for task details.
• The Task Drawer allows interaction with the release flow while the task details are open, thereby enhancing productivity when interacting with multiple tasks.
• The Task Drawer user interface allows you to organize the details of the task by grouping the associated properties into dedicated sections. With the new user interface, you can deliver more focus as well as faster execution of the most common actions like assigning or executing a task.
• The Task Drawer for is a feature in Tech Preview—released in Digital.ai Release 22.3—enabled by default.
• You can disable this feature from the Feature flags section in System settings.

For more information, see Task Drawer.

Task Drawer View:

Progressive Delivery with Digital.ai Release—Argo Rollouts Integration

The objective is to integrate Digital.ai Release with Argo Rollouts so that you can carry out Blue-Green and Canary deployments of applications using Digital.ai Release and Argo Rollouts.

Digital.ai Release's Argo Rollouts plugin supports the following roll-out strategies:

• Blue-Green
• Canary

Once you have this integration in place, all you would be doing is starting a new release—Canary or Blue-Green—whenever you have a new image to deploy.

ArgoRollouts Blue-Green Deployment Dashboard

ArgoRollouts Canary Deployment Dashboard

For more information, see Progressive Delivery Using Release and Argo Rollouts.

Release Maintenance Mode

With Digital.ai Release 22.3, you can now launch Release in a special mode called the Maintenance mode. The primary use is to start Release in maintenance mode for post-upgrade smoke testing and clean-up activities.

Note:

• You cannot push an already running Release into maintenance mode.
• You can put Release in maintenance mode on JVM-based setup only. It is not available with Operator-based setup.

For more information, see Maintenance Mode.

Restart Phase Failure Handler

With Digital.ai Release 22.3, the Restart phase drop-down option is added in Failure Handler to restart the latest version of the current phase.

If the task fails, phase will be restarted based on the latest version of the current phase and release will be automatically resumed.

Display Warning for Entity Deletion

With Digital.ai Release 22.3, a warning dialog box is displayed to indicate reference templates and releases when deleting shared connections.

Live Update of DB Credentials

With Digital.ai Release 22.3, you can update the database credentials in real time without having to restart the server.

Pendo for Customer Insights

With version 22.3 of Digital.ai, some statistics are sent to Pendo for analysis that helps us proactively conduct health checks and speed up troubleshooting.

Version Upgrades—Supported Databases

Release 22.3 supports the following databases.

Database	Versions Supported
PostgreSQL	13.6 and 14.2
MySQL	5.7 and 8.0
Oracle	12c and 19c
Microsoft SQL Server	2017 and 2019
DB2	11.1 and 11.5

Install or Upgrade Digital.ai Release on Kubernetes

Digital.ai Release 22.3 brings you an all new Operator-based installer to install or upgrade Release on Kubernetes clusters.

Here's a list of enhancements.

You no longer need:

• to download the Operator-based installer zip file.
• to manually update the cluster resource file—infrastructure.yaml—or the custom resource definition files—daideploy_cr or dairelease_cr. The new installer brings you the installation/upgrade wizard. Installation and upgrade is as simple as running the xl kube install or xl kube upgrade commands and answering the questions in the wizard.
• a Digital.ai Deploy instance to install or upgrade Deploy or Release
• to encode the plain text license and repository keystore files to base64 format
• to generate the Java repository keystore. You can have the Java repository keystore generated at the time of installation or upgrade. YOu can also choose to use the existing keystore, if required.

Supported Cloud Platforms

You can install or upgrade Digital.ai Release on the following cloud platforms.

• Amazon EKS
• Azure AKS
• Google Cloud Platform GKE
• OpenShift (on AWS)
• Plain k8s (On-premise minikube—only for testing or demonstration purposes. Not for production environments.)

For more information, see Install or Upgrade Digital.ai Release on Kubernetes.

Enhancements to XL CLI 22.3.0

The XL CLI 22.3.0 has been enhanced as part of the new Operator-based installer. Here's a list of changes to XL CLI 22.3.0.

• The xl kube command replaces the xl op command.
• New flags have been added to support the new Operator-based installer.
• The xl op apply (xl kube apply) command no longer exists. If you use the --dry-run flag to generate the files and apply them later to your cluster, use the xl kube install --ref-install or xl kube upgrade --ref-upgrade commands.
• The --keep-files flag no longer exists. The YAML files generated during the installation or upgrade are, by default, preserved in the filesystem post install or upgrade for future use.

For more information, see XL CLI Command Reference.

Known Issues

• D-22765 - In some terminals (Windows), a new line of the same question is added to the command prompt every time you use the arrow key to select one of the options for a multi-line question (with multiple options to select from) of the installation wizard.
• D-22766 - At the command prompt, users are not able to use the backspace to delete the input when the user input is longer than one line. Users are stuck in the second line of the command prompt.

Plugins and Integrations

Here's what's new and changed with plugins and integrations.

Agility Plugin

A new task called Execute Query is introduced. This is used to execute the query and return the output assets according to the status provided in the In Status List and Not In Status List fields.

In Status List:

Not In Status List:

Remote Completion Plugin

In addition to Basic authentication, a new authentication type called OAuth2 authentication is introduced for the Remote Completion plugin.

Jenkins Plugin

The following security vulnerabilities to Jenkins plugin are fixed:

• Checking permission
• Cross-site request forgery
• Server-side request forgery

You will receive a valid error message if you do not have the necessary authorization.

GitLab Plugin

A new task called Query Pipeline status is introduced. This task queries and returns the result when the pipeline reaches any of the following statuses:

• SUCCESS
• FAILED
• CANCELLED

In addition, sorting parameters are added to the QueryTags task.

Kubernetes Plugin

Kubernetes connections are now auto-discovered using the Kubeconfig file. A new connection section is introduced in Digital.ai Release for Kubernetes cluster similar to Kubernetes host.

Enter the Kubeconfig file path in the Local Kubeconfig field and the Context drop-down list will list the clusters from the Kubernetes host to which it's connected.

Deploy Plugin

Deploy tasks in Digital.ai Release stays in Pending state when you use internal variables. This issue is now fixed.

Bug Fixes—22.3.17

D-31824 - Setting up Release without ingress is not asking for the host and hence server.url is not setup in the xl-server-release.conf file. Fixed this issue by setting ingress.hosts and ingress.tls.hosts manually in the existing CR. D-32272 - Fixed an issue that was deleting the last character while setting up the value for a text variable. D-32175 - Fixed an issue in the folder to set the sidebar header and sidebar back item with the same height when a scrollbar is used. D-32157 - Fixed an issue that was throwing console errors while creating templates. D-31829 - Fixed an issue with the comments count that are displayed in the task details section of Release.

Bug Fixes—22.3.16

• D-31886 - Fixed an issue where updating a release variable in a User Input task using the new Task Drawer view was resulting in an incorrect permission error.
• D-31925 - Fixed the UI issue in Gate task.
• D-27979 - Fixed an issue where setting up Release with external authentication services like OIDC resulted in a problem when using special characters in passwords for internal users.
• D-27190 - Fixed an issue with the Remote script task that was causing trouble when running it on Windows server.
• D-27061 - Fixed an issue with the help command in xl kube upgrade --help to display the correct upgrade instructions.

Bug Fixes—22.3.15

• D-27715 - When you try to reopen a task for the second time using the Task Drawer, an error is thrown. This issue is now fixed.
• D-27499 - User input task throws an error if the user doesn't have View release permission. This issue is now fixed.
• D-27117 - Fixed the impact of CVE-2023-44487 on Release and Deploy.
• D-27070 - Release crashes with OutOfMemoryError exception while generating single audit report. This issue is now fixed.
• D-26750 - XL CLI is not exporting the Input properties if it has empty value while generating the YAML file. This issue is now fixed.
• D-26634 - When you create a release using the Create release task, it will create a sub-release out of the original release via a template. However, the tags already created in the template are not available in the sub-release. This issue is now fixed.
• D-26056 - The changes made to the Variables page are reverted back when you edit the Properties page at the same time. This issue is now fixed.
• D-25928 - Fixed the Postgres database error for Unique constraint violation.
• D-25596 - Fixed critical vulnerabilities for Release Docker 23.1.0 image. It is done by updating the ical4j version to resolve CVE-2022-45688.

Bug Fixes—22.3.14

• D-26339 - After upgrading Release to the following versions: xl-release-22.1.16, xl-release-22.2.12, xl-release-22.3.10, xl-release-23.1.1, and xl-release-23.3.0, it is noticed that the scheduled releases and tasks are not running as expected. This issue is now fixed.
• D-26278 - Fixed an issue with the Task Drawer that was not supporting variables in Private key field.

Bug Fixes—22.3.13

Note: There is no Release version 22.3.12.

• D-25770 - Fixed an issue with the Task Drawer properties that was not saving the values in the fields when you switch tasks.
• D-25787 - Fixed an issue with the lookup component that was not allowing the users to update the values in the Lookup fields.
• D-25803 - Fixed an issue with the Jython script task that was not displaying the Open script editor in separate window icon.
• D-25835 - Fixed an issue with the Create Release task that was not allowing the folder name to get populated from the template.

Bug Fixes—22.3.11

• D-25559 - Updated the plugin manager CLI in Windows to prevent it from using the memory params from the wrapper.
• D-25577 - Fixed the third party security vulnerabilities for Release.
• D-24846 - Once Argo CD is installed and Release is integrated with the Argo CD plugin, the applications installed in Argo CD are not getting displayed. An error is thrown when you try to click Discover applications under Application Deployment. This issue is now fixed.
• S-93229 - Updated the documentation links to direct to the new docs site.
• D-25244 - On the Tasks screen, folders with bigger names are breaking when you filter them using the Folder drop-down list. This issue is now fixed.
• D-25400 - In the new Task Drawer, the user is not able to edit the variables in the user-input task that is assigned to a team, even when the user belongs to the team. This issue is now fixed.
• D-25440 - Fixed the lookup component that was not displaying the label on the UI even after reloading.
• D-25891 - When you upgrade a plugin via the Plugin Manager UI, the upgrade fails and an error is thrown. It updates the plugin only in the file system and not in the database. This is a known issue.

Bug Fixes—22.3.10

• D-24193 - When the Release Owner is changed in the Create Release page, the Create Release button is getting disabled. To enable the Create Release button, you must click inside the Release Owner field again. This issue is now fixed.
• D-24195 - Fixed the upgrade issue in Release that caused an error when attaching a new AWS EFS volume to the container using the xebialabs user.
• D-24566 - Fixed the issue with the DeliveryApi where the API call to complete a track item with the Release ID was not being exposed.
• D-24639 - Fixed an issue with the gate tasks that are not being completed properly.
• D-24687 - Fixed an issue where log output was getting cut off in the Task Modal when using markdown format in the Comments and Description fields in Release tasks. This issue only occurred in the Task Modal and not in the new Task Drawer.
• D-24732 - When you use the new Task Drawer view for Deploy task in Release, the input fields like Environment, Version, and Application are not editable in Deploy. It throws a 500 or 401 error. This issue is now fixed.
• D-24800 - When you have the All task permissions permission in Release tasks, you must be able to complete an owned task in advance. This must happen even when you do not have the Perform task transitions in advance permission specifically assigned. This issue is now fixed.
• D-24904 - Fixed the issue with the old Task Modal that failed to load when clicking on the email notification.
• D-24909 - Fixed the issue where the task title was changing even after it was marked as completed.
• D-24966 - Fixed the issue with the autocomplete height for the Dashboard owner field, which was causing scrolling issues for users. The autocomplete height has been adjusted to ensure a seamless scrolling experience for users.
• D-24976 - Fixed the copyright clause in the About Digital.ai Release section with the correct year.
• D-25034 - Fixed the tool tip message of the Perform task transitions in advance permission to avoid confusion in the permission behaviour between the Perform task transitions and Perform task transitions in advance permissions.
• D-25057 - Fixed an issue with the Confirm leave modal on Webhook event triggers, which was being displayed unnecessarily even when no changes were made.
• D-25076 - Fixed the configuration for host aliases in operator based deployment of Release.
• D-25084 - Fixed the race condition between closing the drawer and preUpdateTask in the Notification task, which occurred when adding multiple emails to the To field by pressing enter between email addresses. Previously, an error was thrown when clicking on the Close button. This issue is now fixed.
• D-25106 - Fixed an issue where importing a template with a Create Delivery or Find or Create Delivery task failed due to the presence of a defined folder property.
• D-25144 - Fixed the issue with the way the changes were logged for the Folder variables using the activity log event handler.
• D-25194 - Fixed the quartz configuration for cluster environment to ensure that quartz jobs are being executed on a different node during shutdown.
• D-25234 - Implemented improved exception handling for tasks to ensure that when a task fails, an exception is properly logged, and relevant logs are made available for troubleshooting and analysis.
• D-25254 - Fixed the issue in the Deploy task where users were unable to use the backspace key to delete the package version. This issue specifically occurred in the new Task Drawer, while functioning correctly in the Task Modal.

Bug Fixes—22.3.9

• S-91038 - Audit log now captures the Target ID of the failed task for easier troubleshooting.
• S-91037 - Improved the error message displayed in the "External Script" task type for incorrect credentials.
• S-90981 - Upgraded Underscore.js library to fix CVE-2021-23358.
• S-91423 - When entering or deleting a comment on the Activity tab, there are no placeholder loaders.
• S-90441 - Show disable cursor icon when toggles are not available on the Scheduling tab.
• D-24498 - Fixed the variable list to ensure that it is not editable when a release is in progress.
• D-24594 - Fixed the background color for comment edit actions.
• D-24589 - Bypass security cache on RolesApi invocations to avoid possible stale cache state in clustered environments.
• D-24414 - Fixed spacing issues with descriptions, comments, and other text fields.
• D-24438 - Clearing the 'Script language' field doesn't throw an error.
• D-24456 - Fixed upgrade issues with PostgreSQL Enterprise database.
• D-24500 - Allow variables on the Create Release task variable selector.
• D-23964 - Improved response time on the Folder listing page.
• D-24474 - Fixed the Tasks screen to ensure that it doesn't automatically switch from other tabs to the Overview tab.
• D-24415 - Fixed issue with the "User input" task to prevent incorrect warnings in the server logs.
• D-24458 - Fixed the help icon link in the Warnings page of the Version Control screen.
• D-24400 - Fixed issue with the Task Drawer when a precondition had Windows line endings.

Bug Fixes—22.3.8

• D-23740 - The task gets executed even if it's attribute check fails with an error. This issue is now fixed.
• D-23940 - Fixed issues with List, List Box, and Multiselect List Box variables in the new Task Drawer.
• D-24035 - Fixed the Gate task conditions that were missing on single task view.
• D-24043 - Fixed an issue with the Clear button in the Add Watchers field that was removing the existing watchers.
• D-24044 - Fixed UI bug that was showing Edited flag for new comments.
• D-23959 - Fixed an issue with delivery patterns, which automatically completed all stages before allowing the addition of any linked or tracked items.
• D-24206 - Multi-line descriptions are displayed incorrectly in the deployit-defaults.properties file and throws a syntax error. This issue is now fixed.
• D-23981 - Fixed critical vulnerabilities in Release.

Bug Fixes—22.3.7

• D-23185 - Fixed the security vulnerabilities for Release.
• D-23773 - The Variables in this task drop-down list in the User Input task was not getting disabled when using the Task Modal. However, it is getting disabled when the task is locked in the Task Drawer. This issue is now fixed.
• D-23834 - The Complete button in the Task Drawer and the Create button in the Create new release dialog were both getting enabled even when the mandatory fields are left empty. This issue is now fixed.
• D-23902 - Fixed critical issues that were reported for Spring web in vulnerability scan.
• D-23772 - Users were unable to edit variable values in the User Input task when the task was locked. This issue is now fixed.
• D-23816 - The tiles in dashboards were breaking when viewed in full screen mode. This issue is now fixed.
• D-23819/D-23820 - In the Release flow editor, the Export drop-down list only worked when the text of the drop-down options was clicked. Now, the drop-down options can be clicked anywhere and the export works properly. This issue is now fixed.
• D-23821 - When a long comment was entered, the screen would freeze due to a performance issue. This issue is now fixed.
• D-23789 - After upgrading Release, the server selected via the Connections field in a task disappears intermittently. Sometimes, it disappears during the template and release creation process. It occurs in tasks like JIRA, Jenkins, and other tasks in which you can make connection to a server. This issue occurs only in a cluster installation and is now fixed.
• D-23993 - Users were unable to delete values from the lookup component. This issue has been fixed.
• D-23835 - Variable interpolation was not working in the Failure handler script. This issue is now fixed.

Bug Fixes—22.3.6

Note: There is no Release version 22.3.5.

• D-23216 - Fixed issue causing the xl kube check command to fail when keytool is not installed.
• D-22536 - Fixed an issue that prevented the custom tiles from being exported to PDF.
• D-23071 - When you open an User Input task from an archived release it throws a 404 error. This issue is now fixed.
• D-23383 - Fixed an issue that was breaking the markdown tables created in task descriptions of the Task Drawer.
• D-23482 - Fixed an issue that prevented the Retry button from being displayed for a failed task.
• D-23493 / D-23696 - Fixed an issue that was throwing a 500 error while opening a folder in Release.
• D-23538 - Fixed an issue that prevented the Task Drawer from displaying variables on a Create Release Task.
• D-23568 - Fixed the critical vulnerabilities detected in the Aquasec security scan report by upgrading the libraries.
• D-23697 - When a task contains markdown link with bold formatting text (e.g., **[Google](https://www.google.com)**) in the task description, the Task Drawer becomes invisible. Additionally, the other tasks in that release also becomes invisible until the task containing the markdown link with bold formatting text is deleted. This issue is now fixed.
• D-22986 - Fixed the screen size issue in the script content area to improve the user experience when working with larger scripts.
• D-23501 - Fixed the autocomplete variable tooltip width to manage long variable names.
• D-23551 - Fixed an issue that prevented users from using negative numbers in number properties.
• D-23631 - Fixed the alignment issue in the properties of the Task Drawer. This occurs when you do not have the edit task permission.
• D-23675 - Fixed an issue that blocked the UI when a task has long comments in the Activity tab.
• D-23693 - When you create a Create Release task, and add a folder where this new release must be created. The folder might disappear once you refresh. This issue is now fixed.
• D-23716 - Fixed an issue that prevented users from updating task name when the task name is empty.
• D-23672 - When resolving references to configurations, system checks multiple times if the configuration exists. Caching is introduced to improve the performance.

Bug Fixes—22.3.4

• D-23201 - Fixed the segmentation fault that caused Operator installation to fail on Mac OS Ventura.
• D-22677 - Fixed an issue that prevented tasks from reading the latest comment at runtime.
• D-22319 - The server.url property was ignored when OIDC is enabled and SSL/TLS termination is done by the load balancer without the X-Forwarded-Proto (XFP) header or irules (nginx).
• D-22968 - Fixed an issue that prevented the local users from running the Plugin Manager REST API commands successfully.
• D-23110 - When saving variable values in the User Input task, the operation times out occasionally in clustered environments. This issue is now fixed.
• D-23330 - Fixed the display issue in the custom dashboards.
• D-23218 - When you click the Clear button, the task duration was not getting cleared until you refresh the browser. This issue is now fixed.
• D-23263 - Dashboard tiles are not saving the passwords when you click the back to view mode button. This issue is now fixed.
• D-23438 - The folder dashboard prevents users from adding the Active releases tile. This issue is now fixed.
• S-88382 - Users without Administrator permissions can now opt out of the new Task Drawer feature (from their Profile section in Release) in favor of the Task Modal.

Bug Fixes—22.3.3

Note: There is no Release version 22.3.2.

• D-23033 - When you enter the license as clear text in the editor and generate the answers file, the Digital.ai Release installation fails. This issue is now fixed.
• D-23041 - When you enter the operator image input with a colon, the Digital.ai Release installation fails. This issue is now fixed.
• D-22905 - Context-sensitive tooltip messages are improved for various permissions in Digital.ai Release.
• D-22969 - Users with Edit Folder Notification permission in the Sub folder and not in the Root folder were unable to access the Notification tab in Sub folders. This issue is now fixed.
• D-22995 - An error is being thrown when upgrading Digital.ai Release using IBM Semeru OpenJDK 11. This issue is now fixed.
• D-23017 - A 401 error is returned by Digital.ai Deploy to Release when executing a Deploy task. It's because Release is trying to authenticate with the wrong password. This issue is now fixed.
• D-23050 - In the Template or Release properties page, the Run automated tasks as user field must be auto-populated when you enter a text. This issue is now fixed.
• D-23060 - In the Task Drawer, the lookup component must call lookup only when you try to autocomplete. This issue is fixed now.
• D-23073 - In the Task Drawer, the lookup component is upgraded to support variables.
• D-23074 - In the Task Drawer, the InputMap must show only the property label and not the property name. This issue is now fixed.
• D-23087 - Fixed an issue that prevented the Task Drawer from closing when you hide a task.
• D-23094 - When you click Patterns > Properties, the pattern name is missing in the title section. This issue is now fixed.
• D-23099 - A new state called needs input is implemented for the Task Drawer.
• D-23116 - Fixed an issue with the onChange event to prevent it from getting triggered when the input is readOnly.
• D-23117 - At the folder level, a new folder variable button is displayed even when you do not have the Edit Folder Variable permission. This issue is now fixed.
• D-23024 - When an OIDC user logs out an error is thrown. This issue is now fixed.

Bug Fixes—22.3.1

• D-22279 - When you upgrade Digital.ai Release from 9.5 to latest, in the Task polling settings the status interval (seconds) of the latest version must have the same value as the polling interval (seconds) set for 9.5 version. However, during upgrade an error message is thrown stating Encountered unknown ConfigurationItem property xlrelease.PollingSettings.pollingInterval. This issue in now fixed.
• D-22296 - Updating watchers for a current task using Jython Task API fails. This issue is now fixed.
• D-22429 - Template name is not displayed when you filter the source template via the drop-down list on the Dashboard tile. It's because the template is not displayed in the top one hundred when you list it in alphabetical order. This issue is now fixed by increasing the list size to 1000 from 100.
• D-22618 - When you set a blank value for the Number variable in the Variable screen, the value is automatically set to 0. However, when you do the same in the Release properties screen, it throws a 400 HTTP status code. This issue is now fixed.

Bug Fixes—22.3.0

• D-20546 - Random Jenkins tasks are stuck in the In-progress state when their respective Jenkins jobs are already completed. This issue is now fixed.
• D-20665 - Liquibase error occurs while upgrading Digital.ai Release from 10.0.4 to 22.0.2. This issue is now fixed by adding a validCheckSum property in the 14-a changeset.
• D-22263 - Create Release task fails when the subfolder depth is greater than 4. It is because the ROOT_RELEASE_ID column is too short to hold the value. This issue is now fixed.
• D-22705 - Random Jenkins tasks are stuck in the In-progress state when their respective Jenkins jobs are already completed. This issue is now fixed.
• D-19049 - The Release name field accepts more than 1024 characters when you create a release. However, when you edit the release name and save the changes. It throws an error and this issue is now fixed.
• D-22810 - An error is thrown when you select the list variables in the User Input task. This issue is now fixed.