From 54febce4b11cab536c38de3d1aad36d0e7b19d7a Mon Sep 17 00:00:00 2001 From: Tamir Solomon Date: Thu, 31 Jul 2025 16:53:43 -0400 Subject: [PATCH 1/6] temp commit of release notes --- _posts-gitops/2025-07-25-july-release-notes.md | 1 + _posts/2025-07-25-july-release-notes.md | 16 ++++++++++++++++ 2 files changed, 17 insertions(+) create mode 120000 _posts-gitops/2025-07-25-july-release-notes.md create mode 100644 _posts/2025-07-25-july-release-notes.md diff --git a/_posts-gitops/2025-07-25-july-release-notes.md b/_posts-gitops/2025-07-25-july-release-notes.md new file mode 120000 index 000000000..1be917ae9 --- /dev/null +++ b/_posts-gitops/2025-07-25-july-release-notes.md @@ -0,0 +1 @@ +../_posts/2025-07-25-july-release-notes.md \ No newline at end of file diff --git a/_posts/2025-07-25-july-release-notes.md b/_posts/2025-07-25-july-release-notes.md new file mode 100644 index 000000000..4b06d2f32 --- /dev/null +++ b/_posts/2025-07-25-july-release-notes.md @@ -0,0 +1,16 @@ +--- +title: "Release Notes: July 2025" +description: "" +--- +## Features & enhancements + + + +## Bug fixes +{% if page.collection == "posts" %} +##### Pipelines +* Fixed an issue that caused timeouts when loading UI pages for pipelines with a large number of triggers. + +##### GitOps +{% endif %} +* From 1ad97bd1184cdc30a4e84061ee6208e4af893827 Mon Sep 17 00:00:00 2001 From: Tamir Solomon Date: Fri, 1 Aug 2025 14:10:06 -0400 Subject: [PATCH 2/6] added manual create argo cd app for runtime --- _docs/installation/gitops/manage-runtimes.md | 117 ++++++++++++++++++ .../gitops/runtime-configuration.md | 1 + 2 files changed, 118 insertions(+) diff --git a/_docs/installation/gitops/manage-runtimes.md b/_docs/installation/gitops/manage-runtimes.md index 452bc0bcd..32b061f3b 100644 --- a/_docs/installation/gitops/manage-runtimes.md +++ b/_docs/installation/gitops/manage-runtimes.md @@ -43,6 +43,123 @@ The Runtime's context menu now includes the **Runtime Application** option, whic max-width="60%" %} +Although this step is highly recommended, it’s not required. You can choose to: +* Skip this step and manage the runtime using your own deployment process (e.g., Helm), or +* Manually create your own Argo CD Application to manage the GitOps runtime. + +--- + +## Manually Configuring the Runtime Application + +### 1. Add the Chart and Values Files to Git + +Start by adding the `gitops-runtime` Helm chart to your Git repository. Create both a `Chart.yaml` and a `values.yaml` file. + +#### Chart.yaml +Replace `` with the version of the chart you'd like to install. + +```yaml +apiVersion: v2 +name: codefresh-gitops-runtime +description: Codefresh GitOps Runtime umbrella chart +version: +appVersion: 1.0.0 +dependencies: + - name: gitops-runtime + repository: oci://quay.io/codefresh + version: +``` + +[View the Helm Chart on ArtifactHub](https://artifacthub.io/packages/helm/codefresh-gitops-runtime/gitops-runtime){:target="_blank"} + +--- + +#### values.yaml + +Here's a basic example. Adjust it based on your setup: + +```yaml +gitops-runtime: + argo-cd: + enabled: false + + global: + codefresh: + accountId: + userToken: + secretKeyRef: + name: codefresh-user-token + key: token + + external-argo-cd: + auth: + type: token + tokenSecretKeyRef: + name: gitops-runtime-argo-cd-token + key: token + + runtime: + name: codefresh + isConfigurationRuntime: true +``` + +**Where to find these values:** +* **accountId:** [Account Settings → Account Information](https://g.codefresh.io/2.0/account-settings/account-information){:target="_blank"} +* **userToken:** [User Settings → Generate Token](https://g.codefresh.io/user/settings){:target="_blank"} +* **external Argo CD token:** Create via Argo CD CLI or UI if connecting to an external Argo CD instance. + +> **Note:** Make sure not to commit any secret tokens to Git. + +--- + +### 2. Create an Argo CD Application + +Create an Argo CD Application that points to the Git repo where your runtime manifests are stored. We recommend storing this Application manifest in Git as well. + +```yaml +apiVersion: argoproj.io/v1alpha1 +kind: Application +metadata: + name: + labels: + codefresh.io/entity: runtime + codefresh.io/internal: 'true' +spec: + project: default + source: + repoURL: https://github.com//.git + targetRevision: HEAD + path: + helm: + releaseName: + destination: + namespace: runtime + server: https://kubernetes.default.svc + syncPolicy: + automated: + prune: true + selfHeal: true + allowEmpty: true +``` + +Ensure you include the following labels: +* `codefresh.io/entity: runtime` +* `codefresh.io/internal: 'true'` + +--- + +### 3. (Optional) Manage This Application via Shared Configuration + +We recommend managing the runtime Argo CD application as part of the Internal Shared Configuration (ISC). This ensures consistent configuration across all runtimes. + +1. Go to [Account Settings → Account Information](https://g.codefresh.io/2.0/account-settings/account-information){:target="_blank"} and locate your Shared Configuration repository. +2. Navigate to `runtimes//in-cluster.yaml`. +3. Add the path to your runtime application's manifest under `source.directory.include`. + +If your runtime app manifest is stored in a separate repository, you can: +* Add a second source (see [Argo CD multi-source applications](https://argo-cd.readthedocs.io/en/stable/user-guide/multiple-source-repositories/){:target="_blank"}), or +* Apply the manifest directly to the cluster without wrapping it in a parent application. + ## Upgrade GitOps Runtimes Upgrade provisioned Hybrid GitOps Runtimes to install critical security updates, new functionality, and the latest versions of all components. diff --git a/_docs/installation/gitops/runtime-configuration.md b/_docs/installation/gitops/runtime-configuration.md index 69b2bdad5..c631a88c2 100644 --- a/_docs/installation/gitops/runtime-configuration.md +++ b/_docs/installation/gitops/runtime-configuration.md @@ -64,6 +64,7 @@ Configuring the GitOps Runtime as an Argo CD Application ensures: * **Visibility and monitoring** The Runtime appears in the GitOps Apps dashboard, where you can monitor and manage it as any other Argo CD application. +To view additional ways to configure the GitOps Runtime as an Argo CD Application manually, visit [Managing GitOps Runtimes] ({{site.baseurl}}/docs/installation/gitops/manage-runtimes/#manually-configuring-the-runtime-application) ## Add Git Source to Runtime A **Git Source** is a critical component in GitOps Runtimes, connecting a Git repository to the cluster, enabling deployment and configuration management of Argo CD applications. From fae9a5918aa61344b972c1072e9e2c451d664d3c Mon Sep 17 00:00:00 2001 From: Tamir Solomon Date: Fri, 1 Aug 2025 15:12:39 -0400 Subject: [PATCH 3/6] updated the release notes --- _posts/2025-07-25-july-release-notes.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/_posts/2025-07-25-july-release-notes.md b/_posts/2025-07-25-july-release-notes.md index 4b06d2f32..e467c1f8e 100644 --- a/_posts/2025-07-25-july-release-notes.md +++ b/_posts/2025-07-25-july-release-notes.md @@ -3,14 +3,30 @@ title: "Release Notes: July 2025" description: "" --- ## 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](https://argo-cd.readthedocs.io/en/stable/operator-manual/upgrading/3.0-migration/) 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](https://github.com/codefresh-io/gitops-runtime-helm/releases/tag/0.22.1). ## 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. {% if page.collection == "posts" %} ##### Pipelines * Fixed an issue that caused timeouts when loading UI pages for pipelines with a large number of triggers. +* Fixed an issue where MacOS builds failed with an Unauthorized error when provisioning the runtime, preventing customers from running MacOS builds successfully. +* Fixed an issue where builds intermittently failed with a Failed to prepare dockerfile error, preventing the Dockerfile from being fetched correctly during the build process. +* Fixed an issue where SaaS builds failed due to insufficient disk space by re-enabling cleanup processes. ##### GitOps {% endif %} -* +* 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. From b4b52c3f314ec6c15f24b8143cc7059d10126ed1 Mon Sep 17 00:00:00 2001 From: Tamir Solomon Date: Fri, 1 Aug 2025 15:27:26 -0400 Subject: [PATCH 4/6] fixed links and added one more ref --- _docs/gitops-quick-start/quick-start-configure-runtime.md | 2 +- _docs/installation/gitops/runtime-configuration.md | 3 ++- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/_docs/gitops-quick-start/quick-start-configure-runtime.md b/_docs/gitops-quick-start/quick-start-configure-runtime.md index 5349544df..1b11f6c9e 100644 --- a/_docs/gitops-quick-start/quick-start-configure-runtime.md +++ b/_docs/gitops-quick-start/quick-start-configure-runtime.md @@ -36,7 +36,7 @@ Configuring the GitOps Runtime as an Argo CD Application enables: * Enforcement of Git as the single source of truth To configure, click **Configure as Argo CD Application**. Codefresh will automatically handle the setup—no further action required. - +To manually install the runtime as an Argo CD application, check [Managing GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/manage-runtimes/#manually-configuring-the-runtime-application). ## Add Git Source to Runtime diff --git a/_docs/installation/gitops/runtime-configuration.md b/_docs/installation/gitops/runtime-configuration.md index c631a88c2..56311ff9a 100644 --- a/_docs/installation/gitops/runtime-configuration.md +++ b/_docs/installation/gitops/runtime-configuration.md @@ -64,7 +64,8 @@ Configuring the GitOps Runtime as an Argo CD Application ensures: * **Visibility and monitoring** The Runtime appears in the GitOps Apps dashboard, where you can monitor and manage it as any other Argo CD application. -To view additional ways to configure the GitOps Runtime as an Argo CD Application manually, visit [Managing GitOps Runtimes] ({{site.baseurl}}/docs/installation/gitops/manage-runtimes/#manually-configuring-the-runtime-application) +To view additional ways to configure the GitOps Runtime as an Argo CD Application manually, visit [Managing GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/manage-runtimes/#manually-configuring-the-runtime-application). + ## Add Git Source to Runtime A **Git Source** is a critical component in GitOps Runtimes, connecting a Git repository to the cluster, enabling deployment and configuration management of Argo CD applications. From 0f1807c32a2ae5dec9df26e5e1783ccc8271ee0e Mon Sep 17 00:00:00 2001 From: Tamir Solomon Date: Fri, 1 Aug 2025 16:00:21 -0400 Subject: [PATCH 5/6] minor edits --- _docs/gitops-quick-start/quick-start-configure-runtime.md | 4 ++-- _docs/installation/gitops/runtime-configuration.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/_docs/gitops-quick-start/quick-start-configure-runtime.md b/_docs/gitops-quick-start/quick-start-configure-runtime.md index 1b11f6c9e..9479f6680 100644 --- a/_docs/gitops-quick-start/quick-start-configure-runtime.md +++ b/_docs/gitops-quick-start/quick-start-configure-runtime.md @@ -35,8 +35,8 @@ Configuring the GitOps Runtime as an Argo CD Application enables: * Monitoring health and sync statuses * Enforcement of Git as the single source of truth -To configure, click **Configure as Argo CD Application**. Codefresh will automatically handle the setup—no further action required. -To manually install the runtime as an Argo CD application, check [Managing GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/manage-runtimes/#manually-configuring-the-runtime-application). +To configure, click **Configure as Argo CD Application**. Codefresh will automatically handle the setup—no further action required. +To manually install the runtime as an Argo CD application, visit [Managing GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/manage-runtimes/#manually-configuring-the-runtime-application). ## Add Git Source to Runtime diff --git a/_docs/installation/gitops/runtime-configuration.md b/_docs/installation/gitops/runtime-configuration.md index 56311ff9a..b0ebbe5ff 100644 --- a/_docs/installation/gitops/runtime-configuration.md +++ b/_docs/installation/gitops/runtime-configuration.md @@ -64,7 +64,7 @@ Configuring the GitOps Runtime as an Argo CD Application ensures: * **Visibility and monitoring** The Runtime appears in the GitOps Apps dashboard, where you can monitor and manage it as any other Argo CD application. -To view additional ways to configure the GitOps Runtime as an Argo CD Application manually, visit [Managing GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/manage-runtimes/#manually-configuring-the-runtime-application). +To manually install the runtime as an Argo CD application, visit [Managing GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/manage-runtimes/#manually-configuring-the-runtime-application). ## Add Git Source to Runtime A **Git Source** is a critical component in GitOps Runtimes, connecting a Git repository to the cluster, enabling deployment and configuration management of Argo CD applications. From 716432be8007a0d23d4e423c3d4492f5e296e3ce Mon Sep 17 00:00:00 2001 From: Tamir Solomon Date: Mon, 4 Aug 2025 14:46:43 -0400 Subject: [PATCH 6/6] added wrapping '' on error messages --- _posts/2025-07-25-july-release-notes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_posts/2025-07-25-july-release-notes.md b/_posts/2025-07-25-july-release-notes.md index e467c1f8e..c697b0300 100644 --- a/_posts/2025-07-25-july-release-notes.md +++ b/_posts/2025-07-25-july-release-notes.md @@ -23,8 +23,8 @@ For details, see the [runtime v0.22.1 release notes](https://github.com/codefres {% if page.collection == "posts" %} ##### Pipelines * Fixed an issue that caused timeouts when loading UI pages for pipelines with a large number of triggers. -* Fixed an issue where MacOS builds failed with an Unauthorized error when provisioning the runtime, preventing customers from running MacOS builds successfully. -* Fixed an issue where builds intermittently failed with a Failed to prepare dockerfile error, preventing the Dockerfile from being fetched correctly during the build process. +* Fixed an issue where MacOS builds failed with an 'Unauthorized' error when provisioning the runtime, preventing customers from running MacOS builds successfully. +* Fixed an issue where builds intermittently failed with a 'Failed to prepare dockerfile' error, preventing the Dockerfile from being fetched correctly during the build process. * Fixed an issue where SaaS builds failed due to insufficient disk space by re-enabling cleanup processes. ##### GitOps