Codefresh | Docs | Posts-gitops

Release Notes: August 2025

2025-08-29T00:00:00-05:00

Features & enhancements

GitOps Cloud: Enhanced GitOps App Breadcrumbs

We’re excited to announce a major enhancement to the GitOps App breadcrumbs, designed to streamline your navigation and provide more insightful context. This update is a huge step toward making your workflow more intuitive and efficient.

Direct Runtime navigation: We added the Runtime name directly to your breadcrumb trail. A simple click on the Runtime name will take you to the main applications page, automatically filtered to display only the apps associated with that specific runtime.
Visual clarity with new icons: To help you better understand your application’s hierarchy at a glance, we introduced new icons for each breadcrumb component:
A unique icon for the Runtime Name.
A helpful icon for the ApplicationSet, if your application uses one.
A clear icon for the Application Name itself. These improvements provide a more visually organized and functional navigation system, helping you manage your GitOps applications with greater speed and clarity.

New navigation breadcrumbs

Bug fixes

Pipelines

Fixed recurring “socket hang up” build failures in by increasing engine pod CPU requests and stabilizing dind/network behavior.
Fixed cron trigger creation errors caused by outdated regex handling of short custom cron expressions, adding clearer error messaging.

Release Notes: July 2025

2025-07-25T00:00:00-05:00

Features & enhancements

GitOps: Runtime v0.22: Argo CD 3.0 Upgrade

This runtime release upgrades Argo CD to version 3.0, bringing the latest features and improvements to Codefresh GitOps.

While we haven’t identified any breaking changes for standard Codefresh deployments, please review the following recommendations:

If you have customized any default Argo CD values beyond what Codefresh distributes, you may be affected by changes introduced in Argo CD 3.0.
Review the official Argo CD 3.0 migration guide if you maintain custom configurations.
If you have made extensive customizations, test this runtime upgrade in a non-production environment first.

For details, see the runtime v0.22.1 release notes.

Bug fixes

General

Fixed an issue where Quick Search (CMD + K) did not return any GitOps-related items, including applications. Users can now search and access GitOps items directly through Quick Search as expected.
Fixed an issue where applications nested more than three layers deep were not displayed in the UI tree view. The full application hierarchy now appears correctly in the tree view.

Release Notes: June 2025

2025-06-29T00:00:00-05:00

Features & enhancements

GitOps: New release of GitOps Runtime v0.20.0

We’re excited to announce the release of GitOps Runtime v0.20.0 — a major step forward in improving the stability and reliability of our platform.

This version includes significant architectural improvements and a large number of bug fixes, setting the stage for upcoming enhancements.

This release marks a major milestone in hardening the GitOps runtime for scale, reliability, and enterprise readiness. It also introduces breaking changes, so please read carefully before upgrading.

Read the full release notes.

GitOps: Retention policy for promotions

Promotion workflows and product releases are now retained for up to 9 months. Anything older will be automatically deleted.

Bug fixes

Fixed an issue that caused the GitOps Apps view to return empty results or error messages for some users. The problem occurred when the number of applications exceeded MongoDB’s aggregation pipeline memory limits.
Fixed an issue where Promotion Workflows failed in Restricted Git Source scenarios by ensuring promotions always run in the runtime namespace. Previously, running promotions in the application’s namespace led to missing secret errors (codefresh-token, argocd-token) and blocked execution.
Fixed an issue where the version label displayed an outdated value in the Products dashboard and Release objects.

Release Notes: May 2025

2025-05-15T00:00:00-05:00

This release addresses a number of fixes to improve your experience across the platform.

Features & enhancements

Bug fixes

Wrong revision promoted when a Promotion Flow is triggered manually by clicking Trigger button or automatically.
Release status not updated for product when a Promotion Flow is triggered manually by clicking the Trigger button.
Updated validation for the Name field in Promotion Workflows to not allow underscores.
GitOps permission rule for applications including the Git Source attribute not supported for applications from ApplicationSets.
Removed the SSH option from the Repository field in the Create Git Source form. Selecting SSH resulted in the error failed creating git-source. error: Invalid URL, as SSH is not a valid option for Git Sources.

Release Notes: April 2025

2025-04-30T00:00:00-05:00

Features & enhancements

GitOps: Configure promotion settings with JSON Path Selector and live preview

We’ve made configuring your promotion settings simpler, so you can get it right the first time without guesswork. Using our new preview window, you can now select JSON paths directly from your YAML files. Just point to the file, browse its structure, and the correct path is inserted for you—wildcards included. This takes the guesswork out of configuring your promotion settings.

JSON file selector for promotable properties

Find out more.

GitOps: Align delivery cadence with smart promotion concurrency

Take full control over how releases are promoted across environments with two powerful concurrency modes now available per product.

Queue releases mode

Using the Queue Releases mode, only one release can run at a time for a product. If a new release is triggered while another is promoting, it will wait its turn until the current one finishes.

Terminate releases mode

With the Terminate releases mode, multiple releases can be promoted in parallel, but with a smart safeguard: If a new release starts promoting to an environment that’s already being updated for the product, the older release is automatically terminated in that environment.

Promotion concurrency settings for products

With smart promotion concurrency, you can:

Stay safe in production with sequential releases
Move fast in dev while avoiding collisions
Adapt your promotion strategy per product

This makes it easier to align your GitOps pipelines with your team’s delivery rhythm. Find out more.

GitOps: More intuitive redesigned Products page

Get faster access to key information and actions with our newly redesigned Products page! Better understand release activity and manage your products more efficiently.

New Products page

Everything you need to know about the latest release is now available at a glance:

Release date and version
User who initiated the latest release
Current release status
Direct link to the release view

You also have a direct link to Product Settings—giving you quick access to configuration options you’re likely to update frequently.

Enjoy the new experience.

Bug fixes

Blank screen after login for invited users with SSO sync enabled.
For installations with existing Argo CD, applications added from Helm repository show Unknown status in GitOps Apps dashboard.
Unable to set up OAuth authentication for GitOps Runtime.
Incorrect merge for promotable properties defined as an array (Products > Product Settings > Promotion Settings).