Skip to content

Commit 779a999

Browse files
committed
Update side-by-side content
Updated minor version sync content acc to Ilia's feedback
1 parent 6052937 commit 779a999

File tree

6 files changed

+120
-74
lines changed

6 files changed

+120
-74
lines changed

_docs/installation/behind-the-firewall.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
2-
title: "Runner installation behind firewalls"
2+
title: "Runner installation behind firewalls": Change title - remove installation
3+
working with Runner behind firw
34
description: "Run Codefresh pipelines in your own secure infrastructure"
45
group: installation
56
redirect_from:

_docs/installation/gitops/argo-with-gitops-side-by-side.md

Lines changed: 0 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -30,72 +30,6 @@ There are three configuration changes to make _before_ installing GitOps on the
3030
2. [Synchronize Argo CD chart's minor versions]({{site.baseurl}}/docs/installation/gitops/hybrid-gitops-helm-installation/#gitops-with-argo-cd-synchronize-argo-cd-charts-minor-versions)
3131
3. [Set native Argo CD resource tracking to `label`]({{site.baseurl}}/docs/installation/gitops/hybrid-gitops-helm-installation/#gitops-with-argo-cd-set-native-argo-cd-resource-tracking-to-label)
3232

33-
<!--- ### Switch ownership of Argo project CRDs
34-
If you have Argo project CRDs on your cluster, Codefresh recommends either adopting the CRDs to switch ownership to the GitOps Runtime, or handling the CRDs outside the chart.
35-
Allowing the GitOps Runtime to manage the CRDs also ensures that the CRDs are automatically upgraded whenever the Runtime is upgraded.
36-
37-
You have two options to adopt Argo project CRDs:
38-
39-
#### (Recommended) Adopt the Argo project CRDs
40-
You can either adopt all CRDs which is the recommended option, or only Argo Rollout CRDs.
41-
42-
**Option 1: Adopt _all_ CRDs (Recommended)**
43-
Adopting _all CRDs_ switches ownership for them to the Hybrid GitOps Runtime, allowing them to be managed by the GitOps Runtime chart.
44-
45-
* Run this script _before_ installation:
46-
```
47-
curl https://raw.githubusercontent.com/codefresh-io/gitops-runtime-helm/main/scripts/adopt-crds.sh | bash -s <runtime-helm-release name> <runtime-namespace>
48-
```
49-
50-
**Option 2: Adopt only Argo Rollout CRDs**
51-
You can also adopt only those CRDs that apply to Argo Rollouts. Adopting Argo Rollouts CRDs also switches ownership of the Rollout CRDs to the GitOps Runtime, and ensures that there is only one active Argo Rollouts controller active on the cluster with the GitOps Runtime.
52-
53-
* Run this script _before_ installation:
54-
```
55-
#!/bin/sh
56-
RELEASE=<runtime-helm-release-name>
57-
NAMESPACE=<runtime-namespace>
58-
kubectl label --overwrite crds $(kubectl get crd | grep argoproj.io | awk '{print $1}' | xargs) app.kubernetes.io/managed-by=Helm
59-
kubectl annotate --overwrite crds $(kubectl get crd | grep argoproj.io | awk '{print $1}' | xargs) meta.helm.sh/release-name=$RELEASE
60-
kubectl annotate --overwrite crds $(kubectl get crd | grep argoproj.io | awk '{print $1}' | xargs) meta.helm.sh/release-namespace=$NAMESPACE
61-
```
62-
63-
#### Handle Argo project CRDs outside of the chart
64-
Disable CRD installation under the relevant section for each of the Argo projects in the Helm chart:<br>
65-
`--set <argo-project>.crds.install=false`<br>
66-
where:<br>
67-
`<argo-project>` is the Argo project component: `argo-cd`, `argo-workflows`, `argo-rollouts` and `argo-events`.
68-
69-
See [Argo's readme on Helm charts](https://github.com/argoproj/argo-helm/blob/main/README.md){:target="\_blank"}.
70-
71-
72-
73-
### Synchronize Argo CD chart's minor versions
74-
To avoid potentially incompatible changes or mismatches, ensure that you use the same upstream chart version of Argo CD as that used by Codefresh.
75-
76-
1. Go to `https://github.com/codefresh-io/argo-helm/`.
77-
1. Navigate to `<upstream-chart-version>-<codefresh-version id>/charts/argo-cd/Chart.yaml`. For example, `https://github.com/codefresh-io/argo-helm/blob/argo-cd-5.38.1-1-cap-CR-18361/charts/argo-cd/Chart.yaml`.
78-
1. Find the Argo CD chart version that Codefresh uses in `dependencies.version`, as in this example:
79-
80-
{% include
81-
image.html
82-
lightbox="true"
83-
file="/images/helm-side-by-side-argocd-version.png"
84-
url="/images/helm-side-by-side-argocd-version.png"
85-
alt="Getting the Codefresh upstream chart version of Argo CD"
86-
caption="Getting the Codefresh upstream chart version of Argo CD"
87-
max-width="60%"
88-
%}
89-
90-
91-
92-
### Set native Argo CD resource tracking to `label`
93-
When you install GitOps on a cluster with an existing Argo CD installation, ensure that native Argo CD and GitOps Runtime's Argo CD use different methods to track resources. The same tracking method in both Argo CD instances can result in conflicts with the same application names or when tracking the same resource.
94-
95-
Verify that your native Argo CD instance uses `label` to track resources:
96-
* In the Argo CD namespace, make sure `argocd-cm.application.resourceTrackingMethod` is either not defined, in which case it defaults to `label`, or if defined, is set to `label`.
97-
98-
-->
9933

10034
## Install Hybrid GitOps Runtime via Helm
10135

_docs/installation/gitops/hybrid-gitops-helm-installation.md

Lines changed: 33 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Choose the installation option that best aligns with your specific requirements
3333
* **First-time GitOps Runtime installation**
3434
If this is your first time installing a GitOps Runtime in your Codefresh account, follow these steps:
3535

36-
* [Complete pre-requisites]((#prepare-for-gitops-runtime-installation)): Before starting the installation, complete pre-requisites, as described in Prepare for GitOps Runtime Installation.
36+
* [Complete pre-requisites](#prepare-for-gitops-runtime-installation): Before starting the installation, complete pre-requisites, as described in Prepare for GitOps Runtime Installation.
3737
* [System requirements](#minimum-system-requirements): Check the minimum system requirements to ensure smooth installation.
3838
* [Step-by-step installation](#install-first-gitops-runtime-in-account): Follow our step-by-step guide to install the Hybrid GitOps Runtime from the Codefresh UI.
3939

@@ -112,17 +112,43 @@ See [Argo's readme on Helm charts](https://github.com/argoproj/argo-helm/blob/ma
112112
### GitOps with Argo CD: Synchronize Argo CD chart's minor versions
113113
To avoid potentially incompatible changes or mismatches, ensure that the native Argo CD instance uses the same upstream version of Argo CD as that used by Codefresh.
114114

115-
1. Go to `https://github.com/codefresh-io/argo-helm/<upstream-chart-version>-<codefresh-version id>/charts/argo-cd/Chart.yaml`.
116-
For example, `https://github.com/codefresh-io/argo-helm/blob/argo-cd-5.38.1-1-cap-CR-18361/charts/argo-cd/Chart.yaml`.
117-
1. Find the Argo CD version in `app.version`, as in this example:
115+
1. Get the Argo CD chart version used by Codefresh from the DEPENDENCIES either in ArtifactHub or from the gitops-runtime's `Chart.yaml` in Git:
116+
* [ArtifactHub](https://artifacthub.io/packages/helm/codefresh-gitops-runtime/gitops-runtime){:target="\_blank"}:
117+
{% include
118+
image.html
119+
lightbox="true"
120+
file="/images/runtime/helm/helm-side-by-side-argocd-version-dependencies.png"
121+
url="/images/runtime/helm/helm-side-by-side-argocd-version-dependencies.png"
122+
alt="Getting the Codefresh chart version of Argo CD from Dependencies in ArtifactHub"
123+
caption="Getting the Codefresh chart version of Argo CD from Dependencies in ArtifactHub"
124+
max-width="60%"
125+
%}
126+
127+
* [`Chart.yaml`](https://github.com/codefresh-io/gitops-runtime-helm/blob/main/charts/gitops-runtime/Chart.yaml):
128+
129+
{% include
130+
image.html
131+
lightbox="true"
132+
file="/images/runtime/helm/helm-side-by-side-argocd-version-dependencies.png"
133+
url="/images/runtime/helm/helm-side-by-side-argocd-version-dependencies.png"
134+
alt="Getting the Codefresh chart version of Argo CD from Dependencies in Chart.yaml"
135+
caption="Getting the Codefresh chart version of Argo CD from Dependencies in Chart.yaml"
136+
max-width="60%"
137+
%}
138+
139+
1. Go to `https://github.com/codefresh-io/argo-helm/blob/argo-cd-<dependency-chart-version>/charts/argo-cd/Chart.yaml`
140+
where:
141+
<dependency-chart-version> is the Codefresh Argo CD chart version you retrieved in step 1, for example, `5.38.1-1-cap-CR-18361`.
142+
143+
1. Check the `appVersion` as in the example below.
118144

119145
{% include
120146
image.html
121147
lightbox="true"
122148
file="/images/runtime/helm/helm-side-by-side-argocd-version.png"
123149
url="/images/runtime/helm/helm-side-by-side-argocd-version.png"
124-
alt="Getting the Codefresh upstream chart version of Argo CD"
125-
caption="Getting the Codefresh upstream chart version of Argo CD"
150+
alt="Check versions"
151+
caption="Check versions"
126152
max-width="60%"
127153
%}
128154

@@ -244,7 +270,7 @@ You can define one of three different access modes:
244270
**GitOps with Argo CD**
245271
* `fullnameOverride` configuration for resource conflicts
246272
Installing GitOps Runtime on the same cluster as Argo CD can cause conflicts when resources in both native and Codefresh's Argo CD instances have the same name or attempt to control the same objects.
247-
Customizing `fullnameOverride` values for Argo CD and Argo Rollouts in the GitOps Runtime's `values` file prevents these conflicts.
273+
Customizing `fullnameOverride` values for Argo CD and Argo Rollouts if installed in the GitOps Runtime's `values` file prevents these conflicts.
248274

249275
* Resource tracking with `annotation`
250276
Installing GitOps Runtime on the same cluster as Argo CD require that each Argo CD instance uses different methods to track resources. Using the same tracking method can result in conflicts when both instances have applications with the same names or when tracking the same resource. Setting the GitOps Runtime's Argo CD resource tracking to `annotation` prevents such conflicts.
Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: "Release Notes: August 2023"
3+
description: "Release Notes for Codefresh Pipelines and GitOps"
4+
---
5+
6+
## Features & enhancements
7+
8+
### Pipelines: Enforce access to scopes for account
9+
With this feature, Codefresh admins gain enhanced control over the security of their pipelines by being able to restrict access to specific endpoint scopes.
10+
Scopes are defined at the account level, ensuring a consistent security baseline for all pipelines. These predefined scopes are inherited by every pipeline, which Codefresh admins can override for individual pipelines when necessary.
11+
12+
{% include
13+
image.html
14+
lightbox="true"
15+
file="/images/whats-new/aug23/rel-notes-aug23-pipeline-scopes-setting.png"
16+
url="/images/whats-new/aug23/rel-notes-aug23-pipeline-scopes-setting.png"
17+
alt="Configure scopes for pipeline"
18+
caption="Configure scopes for pipeline"
19+
max-width="60%"
20+
%}
21+
22+
For details, see [Configure scopes for pipelines]({{site.baseurl}}/docs/pipelines/configuration/pipeline-settings/#configure-pipeline-scopes).
23+
24+
<br><br>
25+
26+
### Pipelines: Initialization metric in Datadog
27+
Codefresh now reports an additional pipeline metric to Datadog. Reported metrics includes the duration of the initialization step for pipelines.
28+
29+
<br><br>
30+
31+
32+
### GitOps: Application Groups in GitOps Apps dashboard
33+
34+
Introducing a new view in the GitOps Apps dashboard, the Group view!
35+
The Group view for GitOps applications is a simple and efficient way to streamline application deployment monitoring within your enterprise.
36+
37+
With App Groups, you can effortlessly focus on specific app deployments, as it consolidates deployment information for all applications within the group in the same view. This feature eliminates the need to navigate between the different applications for information on them.
38+
Tailor groupings according to the unique requirements of your organization and applications.
39+
40+
41+
{% include
42+
image.html
43+
lightbox="true"
44+
file="/images/whats-new/aug23/rel-notes-aug23-app-group-page.png"
45+
url="/images/whats-new/aug23/rel-notes-aug23-app-group-page.png"
46+
alt="Application Groups in GitOps Apps dashboard"
47+
caption="Application Groups in GitOps Apps dashboard"
48+
max-width="60%"
49+
%}
50+
51+
Codefresh also adds the Group name as an annotation to the application manifest for easy organization and management.
52+
53+
For details, see [Application Groups for GitOps applications]({{site.baseurl}}/docs/deployments/gitops/gitops-app-groups/).
54+
55+
56+
57+
58+
59+
60+
61+
## Bug fixes
62+
63+
### General
64+
* Unable to sign in with SSO (Single Sign-On).
65+
66+
### Pipelines
67+
* Prefix for Docker registries omitted when using a custom Docker registry as a Public Marketplace Registry.
68+
* Pipeline trigger for BitBucket server does not fire on commit.
69+
* Pipeline resuming execution after approval shows previously executed steps as skipped in Codefresh UI.
70+
* Delay in start times for child pipelines triggered by parent pipeline including a large set of codefresh-run steps set to run in parallel.
71+
* Retrying a workflow displays duplicate metrics in Datadog.
72+
73+
74+
### GitOps
75+
* Out of memory for Hosted GitOps Runtimes.
76+
* Clicking the **Current State** or the **Timeline** tab of an application opens the Home dashboard instead of the tabs.
77+
* Unable to connect to a Git provider when installing Hosted GitOps Runtimes.
78+
* Deleted GitOps applications continue to be displayed in the GitOps Apps dashboard.
79+
* (On-premises only) `DISABLED_CONCURRENT_SESSIONS` set to `true` results in `UNAUTHORIZED_ERROR token is not valid` error for graphql API call.
80+
81+
82+
83+
84+
85+
62.7 KB
Loading
179 KB
Loading

0 commit comments

Comments
 (0)