Skip to main content

139 docs tagged with "release"

View all tags

Air-gapped Installation of Application Images

Learn how to manage application images in air-gapped environments. Following are the five different options you can use to ensure your application images are available in air-gapped environments.

Backup of the Release before upgrade

This document provides procedures for backing up the Digital.ai Release installation on a Kubernetes (K8s) cluster. Follow these steps to ensure your data and configuration are protected before performing upgrades or maintenance.

Calendar view

This topic provides an overview of the Calendar view in Digital.ai Release, including how to navigate different calendar views, filter releases, mark special days, and export the calendar.

Change a Task's Type

This topic explains how to change the type of a task in Release, including the necessary permissions for modifying tasks in templates, planned releases, and active releases.

Cloud-native How-tos

Step-by-step guides for cloud-native deployment scenarios with Digital.ai Release, including AWS EKS, Argo CD, and deployment strategies.

Code releases using the Releasefile

This topic explains how Digital.ai Release can define a release from a Groovy-based DSL script, that describes all the phases, tasks, and task-groups in the release. This enables you to store release definitions as code in version control and gives you programmatic control over a release when creating it.

Configure HTTP2 for Release

This topic illustrates how to configure the settings required to install Release with HTTP2 backend enabled on a Kubernetes cluster.

Configure SSL/TLS in Kubernetes Environment

This topic illustrates how to configure SSL/TLS with Digital.ai Release. A self-signed certificate is used for illustrative purposes in this procedure. However, you may want to replace it with your own trusted certificate for production environments, which you can do by creating a new Secret object in Kubernetes that contains your certificate and then configuring the ingress controller to use it.

Configure the JVM DNS TTL

This guide explains how to configure the DNS Time-to-Live (TTL) settings for the Release Java Virtual Machine (JVM) in a Kubernetes environment. Proper TTL configuration is crucial for managing how long DNS resolutions are cached, which can affect system performance and network behavior.

Confluence Plugin

The Digital.ai Release Confluence plugin integrates your Confluence workspace with Release, making it easy to manage documentation as part of your release pipeline. It enables you to automate page creation, updates, and related actions so your Confluence content stays aligned with your delivery workflow.

Core Concepts

Digital.ai Release is a release orchestration platform. It lets teams plan, track, and execute releases from a single location, giving every stakeholder — developers, QA engineers, release managers, and operations teams — a consistent view of release status.

Create a Release Trigger

Release triggers are an automated way to create and run a release. When you create a trigger for a release template and enable it, Release will execute the script associated with the trigger at a specified interval. When the trigger starts, it will create and start a new release from the template. A good example of a trigger is one that polls a source code management system like GitHub for a change and starts a release as a result.

Create Delivery Task

A Create Delivery task is an automatic task that creates a new delivery from a delivery pattern.

Create Release Variables

In Digital.ai Release, release variables are scope-specific configuration elements that help manage dynamic values within release templates and instances. Unlike global variables, release variables are confined to the template or release where they are created.

Custom Resource Keys Migration During Upgrade

This guide explains how custom resource keys are migrated during the Digital.ai Release operator upgrade process. Understanding this process is crucial for maintaining your configuration when upgrading to newer versions of the operator.

Dashboard Templates

This topic explains how to use dashboard templates in Digital.ai Release to quickly build a dashboard that provides information on your deployments and releases.

Delivery Patterns Tutorial

Delivery Patterns in Release allow you to create pipelines where each team can work at its own timelines and tools, and converge at synchronized points.

Delivery Tasks

Overview of delivery tasks in Digital.ai Release for creating, finding, and managing deliveries and tracked items.

Disable SNI Check in Release

When running Digital.ai Release with HTTPS enabled in Kubernetes, you may need to disable the Server Name Indication (SNI) check in certain scenarios. This guide explains how to safely disable the SNI check using Kubernetes commands.

Enable File Logging

This topic explains how to enable file logging in the Kubernetes cluster for Release application.

Find Delivery Task

A Find Delivery task is an automatic task that searches for an existing delivery by tracked item or by name.

Find or Create Delivery Task

A Find Or Create Delivery task is an automatic task that searches for an existing delivery or creates a new one from a delivery pattern.

Folder Teams and Permissions

Teams are used to group one or more users in Release. Folder, template, or release-level permissions can be assigned to one or more teams.

Handling File System Changes in Operator-based Installation

This guide explains how to manage file system operations in Digital.ai Release when using Operator-based installation. By default, containers run with read-only file systems for enhanced security. Learn how to configure various storage options including temporary storage, persistent volumes, and custom mounts to meet your application's needs while maintaining security best practices.

How to Find Identifiers for REST API

To use the Release REST API, you need to know the unique identifiers for templates, releases, phases and tasks. This topic explains where you can find them.

Install or Upgrade Digital.ai Release on an Air-gapped Environment

You can install Release in an air-gapped environment disconnected from the public internet. This topic provides information about installing and upgrading Release in such environments using a Minikube cluster and a custom image registry. For other Kubernetes platforms, steps are similar to the ones listed here for Minikube as long as the custom image registry contains all the required images.

Install—Release—On-premise Kubernetes

Use these instructions to install Digital.ai Release on a minikube multi-node cluster for testing or illustration purposes. Do not use these instructions to set up a production environment.

Introduction to Delivery Patterns

The Delivery Patterns feature in Release allows you to use deliveries and tracked items to synchronize multiple releases together. This allows you to design delivery patterns that conform to the release standards being used by your organization, such as SAFe.

Manage Plugins Offline in Kubernetes Environment

This guide explains how to manage Digital.ai Release plugins in offline mode when working with a Release cluster created using the Operator-based installer. You'll learn multiple approaches to manage plugins when the Release UI is unavailable or not functioning properly.

Manage Release Template as Code

This tutorial is intended to help you get started with DevOps as Code in Release. It describes how to generate a DevOps as Code YAML file from an existing Release template and manage it in source control.

Manage Releases

The Releases page provides a centralized view for managing and tracking releases.

Manage Templates and Releases with Folders

This document explains what folders are in Digital.ai Release, how to organize them, manage permissions, configure notifications, and set up GitOps-based version control. You'll learn how to structure folders to match your organization and use them effectively to manage templates, releases, and configurations across teams.

Manage Transitions

Delivery stage transitions force all the tracked items in a stage to wait together until the transition conditions are met, or the transition is manually completed. This allows you to synchronize the releases together based on criteria such as business approval, scheduling, or the status of tracked items.

Managing Delivery Patterns

This topic describes how to create and manage delivery patterns. A delivery pattern allows you to design a flow of stages that the tracked items in a delivery must go through. You can reuse these patterns in multiple deliveries.

Manual PostgreSQL Upgrade (CNPG Operator-Managed)

This guide covers the manual steps required to upgrade PostgreSQL across a major version when using the CloudNativePG (CNPG) operator-based PostgreSQL installation, specifically when PostgreSQL is managed through the experimental postgresql-operator and postgresql-cluster rather than through the Release CR's built-in spec.postgresql keys. Use this manual process only if the automatic upgrade fails or your cluster doesn't meet its prerequisites.

Manual upgrade PostgreSQL

PostgreSQL cannot be automatically upgraded during an operator-to-operator or Helm-to-operator upgrade due to incompatible data formats between different PostgreSQL server versions. In such cases, a manual upgrade is necessary. The process involves first backing up the PostgreSQL data, then upgrading to the new PostgreSQL version, and finally restoring the data in the upgraded version.

Mark Tracked Items Task

A Mark Tracked Items task is an automatic task that completes or skips one or more tracked items on a running delivery.

Migrate from Bitnami to Operator-Managed PostgreSQL

This guide covers the manual steps required to migrate from the Bitnami chart-managed PostgreSQL installation (the default up to and including operator 25.1 releases) to the CloudNativePG (CNPG) operator-managed equivalent introduced in operator 25.3 releases.

Organizing Release

Learn how to organize your Digital.ai Release environment with folders, GitOps versioning, users, roles, and connections.

Overview of Dashboard Tiles

The release dashboard tiles topic provides you with an overview of your planning information with the help of graphical representations. The release dashboard can be customized as per your requirement by adding, configuring, moving, and removing tiles to show the planning information and details about the release status.

Overview of Dashboards

This topic provides an overview of Digital.ai Release reports, including types of dashboards, report permissions, and report caching. Digital.ai Release reports display graphs and statistics based on historical release data stored in the archive database, and are available to users with the appropriate permissions.

Overview of Reports

This topic describes how release reports display graphs and statistics based on historical release data.

Parameters in the Custom Resource File

Here is the list of the main parameters for the Digital.ai Release Custom Resource (CR). The following table lists the parameters available in the Digital.ai Release's dairelease_cr.yaml file and their default values.

Profile Settings

This how-to guide explains how to configure and manage your user profile settings in Release. You can update personal details, change your password, adjust regional preferences, select your default landing page, and manage product analytics and guidance options.

Register a Tracked Item

This topic describes how to add one or more tracked items to a delivery. If you want to track a new feature as part of your end to end delivery of a release, you can add the feature as a tracked item in the delivery.

Register Tracked Item Task

A Register Tracked Items task is an automatic task that registers one or more tracked items to a running delivery.

Release Audit Report

This topic covers the audit report in Digital.ai Release, which provides full traceability and auditability for auditors. You can generate an audit report for releases that are in progress, completed, or archived.

Release Concepts

Core concepts for understanding releases in Digital.ai Release, including the release lifecycle, views, history, and risk awareness.

Release Dashboard

The release dashboard displays planning information and release status through configurable tiles. You can add, move, resize, and remove tiles to build a view that fits your team's needs.

Release Flow Editor

The Flow Editor shows the phases and tasks in a release or a template. You can use this view to add, move, edit, and delete phases and tasks.

Release History

The Release History provides a complete audit trail of all activities performed in a release, capturing user actions along with dates and times. This helps track progress, monitor changes, and troubleshoot issues with greater visibility.

Release Lifecycle

This topic explains the different stages and states a release goes through during its lifecycle in Digital.ai Release.

Release MCP Tools Plugin

The Release MCP Tools Plugin provides the Model Context Protocol tools that AI agents use to work with Digital.ai Release.

Release Planner

The Release planner view provides an interactive Gantt chart to view and edit the duration of the phases and tasks in a release or template. The Gantt chart is a combined timeline of the template or release, its phases, and the tasks within.

Release Properties

This topic covers Release properties, which are configurable attributes that influence the behavior and execution of a release.

Release table view

The Release table view provides an alternative view of a template or release that is optimized for working with tasks.

Release Templates

In Release, templates are like blueprints for releases. You can use templates to model the ideal process of a release flow. A template can describe a procedure that is used to deliver different applications, or it can describe a procedure that is used to release a particular application and that will be reused for different versions of the application.

Release Value Stream Report

This topic provides information on the Release value stream report, which evaluates the quality of completed and aborted releases. The report draws data from the Release archive database, so it does not include releases that are completed or aborted but not yet archived. For more information, see completed and aborted and archive database.

Release Views

Monitor and manage your releases using calendar, table, planner, code, and relationships views in Digital.ai Release.

Reports Dashboard

This topic provides key information on flagged releases and highlights those with the highest level of automation.

Restart a Phase in an Active Release

In an active release, you can abort the current phase and restart the execution from any past phase. This can be required if some parts of the release procedure must be repeated. For example, QA rejects a version of the application for release and the test phase must be repeated with an updated version.

Risk Awareness

Release calculates a risk level for each release based on different factors such as flags, failed or failing states, or due dates. You can see the releases with a high risk level and take the appropriate actions.

Schedule Releases

In Release, you can schedule your releases by setting start dates and times, end dates and times, and durations on templates, releases, phases, and tasks. When you set dates and durations on phases and tasks, Release automatically adjusts other phases and calculates the release duration and end date.

Scheduling Pods with Node Selectors, Node Affinity and Tolerations

Kubernetes provides flexible mechanisms to control pod scheduling across your cluster nodes. This guide explores three powerful options for scheduling pods to specific nodes: node selectors, node affinity, and tolerations. Each approach offers different levels of control and complexity to help you optimize your workload placement.

Set Up Custom Image Registry

This article explains how to set up a custom image registry for installing or upgrading Release. A custom image registry can be either public (not password-protected) or private (password-protected).

Set up Truststore for Release

This topic illustrates on how to set up a truststore to store trusted certificates that are used to verify the identities of parties in a secure communication.

Setting Up JDBC

Starting with Digital.ai Release version 24.3.0, there are two types of images available for Kubernetes-based setups with an external database or internal message queue: slim and non-slim.

Start a Release From a Template

This topic describes how to create a release from a template using various methods and the steps required before starting the release.

Store Reports and Logs on S3—Kubernetes

This topic describes how to configure Digital.ai Release on Kubernetes to store reports and task logs on Amazon S3. This setup eliminates the need for persistent volumes, making storage management easier for Kubernetes-based release instances.

Task Types and Creation

Overview of task types in Digital.ai Release, including manual, automated, and custom tasks, and how to extend them.

Triggers

Triggers are automation tools that initiate release tasks based on specific conditions or events. They help streamline your release process by automating repetitive tasks and responding to external events.

Using an Existing PostgreSQL Database

If you plan to use an existing database—one that is not created by default by the Operator-based installer—you must configure the relevant database parameters in the dairelease_cr.yaml file.

Using an External Database

This topic illustrates how to use an external database instead of the one that is provided with the operator itself.

Using Dependent Properties in Type Definitions

Dependent properties within the XML type-definitions enables dynamic user inputs that adapt based on user selections. This functionality is essential for tasks requiring context-specific input, ensuring that only relevant fields and options are presented, thereby enhancing the user experience.

Using Secret References in CR

This topic illustrates how to replace the CR values that are in clear-text format in the CR with the secret references.

Variables in Digital.ai Release

Digital.ai Release uses variables to make your release templates more flexible and reusable. Variables allow you to parameterize your release processes, making it easier to manage dynamic content and configuration across different environments and scenarios.

Wait for Stage Task

A Wait For Stage task is an automatic task that makes the running release wait for a stage to be completed on a running delivery before proceeding.

Wait for Tracked Item Task

A Wait For Tracked Items task is an automatic task that waits for items to exist or be completed in a stage on a running delivery.

Work with Phases and Tasks

In Release, phases in a template or release represent blocks of activities that occur in succession. Activities in a template or release are modeled as tasks, which are logically grouped in phases. You can use the release flow editor to manage phases and tasks.

Workflow Category Settings

Workflows are bundled within the Release application itself, and are categorized into multiple types based on its use-cases. Additionally, you can also create new workflows and assign it to a specific category.

Workflow to Create Secret in AWS Secrets Manager

The objective is to illustrate how to use the AWS SecretsManager create secret workflow in Digital.ai Release to create secrets in AWS Secrets Manager, which can again be looked up and substituted across Digital.ai Release templates and workflows.

Workflow to Create Secret in Azure KeyVault

The objective is to illustrate how to use the Azure KeyVault create secret workflow in Digital.ai Release to create secrets in Azure KeyVault, which can again be looked up and substituted across Digital.ai Release templates and workflows.

Workflow to Delete Application in Argo CD

The objective is to illustrate how to use the ArgoCD delete application workflow in Digital.ai Release to delete an application in Argo CD that runs in a Kubernetes cluster.

Workflow to Trigger CheckmarxOne Scan on Git Repository

This topic illustrates how to use the CheckmarxOne scan Git repository workflow to initiate a CheckmarxOne scan on your git repository, review scan results, and verify compliance directly from within the Digital.ai Release.

Workflow to Update Application in Argo CD

The objective is to illustrate how to use the ArgoCD update application workflow in Digital.ai Release to update an application in Argo CD that runs in a Kubernetes cluster.

Workflow to Update Secret in AWS Secrets Manager

The objective is to illustrate how to use the AWS SecretsManager update secret workflow in Digital.ai Release to update secrets in AWS Secrets Manager, which can again be looked up and substituted across Digital.ai Release templates and workflows.

Workflow to Update Secret in Azure KeyVault

The objective is to illustrate how to use the Azure KeyVault update secret workflow in Digital.ai Release to update secrets in Azure KeyVault, which can again be looked up and substituted across Digital.ai Release templates and workflows.

Workflows Catalog

Note: Workflows are bundled with the Release application by default. However, you must have the relevant plugins installed to view these workflows in the Workflows folder. For example, you must have the Deploy plugin installed in Release to view the workflows in the Workflows > Digital.ai Deploy folder.

Workflows Overview

With Digital.ai Release 23.3, new self-service workflows have been introduced to help Developers onboard their applications more easily with minimal knowledge of tools. These workflows guide users through step-by-step execution of tasks, reducing complexity in setting up environments. They leverage cloud benefits such as scalability, availability, and optimization of applications for the cloud for improved performance and reliability. This also helps ensure adherence to cloud security and compliance best practices.