Skip to content

Commit 592e924

Browse files
authored
Merge pull request #60649 from Srivaralakshmi/GitOpsRN-1.9
Document GitOps v1.9 Release Notes
2 parents 15d46d4 + e19488c commit 592e924

7 files changed

+154
-4
lines changed

_topic_maps/_topic_map.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1964,8 +1964,8 @@ Topics:
19641964
File: run-gitops-control-plane-workload-on-infra-nodes
19651965
- Name: Sizing requirements for GitOps Operator
19661966
File: about-sizing-requirements-gitops
1967-
# - Name: Collecting debugging data for a support case
1968-
# File: collecting-debugging-data-for-support
1967+
- Name: Collecting debugging data for a support case
1968+
File: collecting-debugging-data-for-support
19691969
- Name: Troubleshooting issues in GitOps
19701970
File: troubleshooting-issues-in-GitOps
19711971
- Name: Jenkins

cicd/gitops/configuring-sso-on-argo-cd-using-dex.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ After the {gitops-title} Operator is installed, Argo CD automatically creates a
1010

1111
[IMPORTANT]
1212
====
13-
The `spec.dex` parameter in the ArgoCD CR is deprecated. In a future release of {gitops-title} v1.9, configuring Dex using the `spec.dex` parameter in the ArgoCD CR is planned to be removed. Consider using the `.spec.sso` parameter instead.
13+
The `spec.dex` parameter in the ArgoCD CR is deprecated. In a future release of {gitops-title} v1.10.0, configuring Dex using the `spec.dex` parameter in the ArgoCD CR is planned to be removed. Consider using the `.spec.sso` parameter instead.
1414
====
1515

1616
include::modules/gitops-creating-a-new-client-in-dex.adoc[leveloffset=+1]

cicd/gitops/gitops-release-notes.adoc

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,14 @@ include::modules/go-compatibility-and-support-matrix.adoc[leveloffset=+1]
2323
include::modules/making-open-source-more-inclusive.adoc[leveloffset=+1]
2424

2525
// Modules included, most to least recent
26+
include::modules/gitops-release-notes-1-9-0.adoc[leveloffset=+1]
27+
// 1.25.0 additional resources, OCP docs
28+
ifdef::openshift-enterprise[]
29+
[role="_additional-resources"]
30+
.Additional resources
31+
* xref:../../operators/admin/olm-configuring-proxy-support.adoc#olm-inject-custom-ca_olm-configuring-proxy-support[Injecting a custom CA certificate]
32+
endif::[]
33+
2634
include::modules/gitops-release-notes-1-8-3.adoc[leveloffset=+1]
2735
2836
include::modules/gitops-release-notes-1-8-2.adoc[leveloffset=+1]

modules/gathering-data-specific-features.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,8 +65,12 @@ endif::openshift-dedicated[]
6565

6666
|`registry.redhat.io/workload-availability/node-maintenance-must-gather-rhel8:v<installed-version-NMO>`
6767
|Data collection for the Node Maintenance Operator (NMO).
68+
69+
|`registry.redhat.io/openshift-gitops-1/gitops-must-gather-rhel8:v1.9.0`
70+
|Data collection for {gitops-title}.
6871
|===
6972

73+
7074
endif::openshift-origin[]
7175

7276
ifdef::openshift-origin[]

modules/gitops-disable-dex.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Dex is installed by default for all the Argo CD instances created by the Operato
1010

1111
[IMPORTANT]
1212
====
13-
In {gitops-title} v1.6.0, `DISABLE_DEX` is deprecated and is planned to be removed in {gitops-title} v1.9.0. Consider using the `.spec.sso.dex` parameter instead. See "Enabling or disabling Dex using .spec.sso".
13+
In {gitops-title} v1.6.0, `DISABLE_DEX` is deprecated and is planned to be removed in {gitops-title} v1.10.0. Consider using the `.spec.sso.dex` parameter instead. See "Enabling or disabling Dex using .spec.sso".
1414
====
1515

1616
.Procedure
Lines changed: 129 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,129 @@
1+
// Module included in the following assembly:
2+
//
3+
// * gitops/gitops-release-notes.adoc
4+
:_content-type: REFERENCE
5+
[id="gitops-release-notes-1-9-0_{context}"]
6+
= Release notes for {gitops-title} 1.9.0
7+
8+
{gitops-title} 1.9.0 is now available on {product-title} 4.12 and 4.13.
9+
10+
[id="errata-updates-1-9-0_{context}"]
11+
== Errata updates
12+
13+
=== RHSA-2023:112944 - {gitops-title} 1.9.0 security update advisory
14+
15+
Issued: 2023-06-09
16+
17+
The list of security fixes that are included in this release is documented in the following advisory:
18+
19+
* link:https://access.redhat.com/errata/RHSA-2023:112944[RHSA-2023:112944]
20+
21+
If you have installed the {gitops-title} Operator, run the following command to view the container images in this release:
22+
23+
[source,terminal]
24+
----
25+
$ oc describe deployment gitops-operator-controller-manager -n openshift-operators
26+
----
27+
28+
[id="new-features-1-9-0_{context}"]
29+
== New features
30+
31+
The current release adds the following improvements:
32+
33+
* With this update, you can use a custom `must-gather` tool to collect diagnostic information for project-level resources, cluster-level resources, and {gitops-title} components. This tool provides the debugging information about the cluster associated with {gitops-title}, which you can share with the Red Hat Support team for analysis. link:https://issues.redhat.com/browse/GITOPS-2797[GITOPS-2797]
34+
+
35+
[IMPORTANT]
36+
====
37+
The custom `must-gather` tool is a Technology Preview feature.
38+
====
39+
40+
* With this update, you can add support to progressive delivery using Argo Rollouts. Currently, the supported traffic manager is only {SMProductName}. link:https://issues.redhat.com/browse/GITOPS-959[GITOPS-959]
41+
+
42+
[IMPORTANT]
43+
====
44+
Argo Rollouts is a Technology Preview feature.
45+
====
46+
47+
[role="_additional-resources"]
48+
.Additional resources
49+
* link:https://argo-rollouts-manager.readthedocs.io/en/latest/crd_reference/[Using Argo Rollouts]
50+
51+
[id="deprecated-features-1-9-0_{context}"]
52+
== Deprecated and removed features
53+
54+
* In {gitops-title} 1.7.0, the `.spec.resourceCustomizations` parameter was deprecated. The deprecated `.spec.resourceCustomizations` parameter is planned to be removed in the upcoming {gitops-title} GA v1.10.0 release. You can use the new formats `spec.ResourceHealthChecks`, `spec.ResourceIgnoreDifferences`, and `spec.ResourceActions` instead. link:https://issues.redhat.com/browse/GITOPS-2890[GITOPS-2890]
55+
56+
* With this update, the support for the following deprecated `sso` and `dex` fields extends until the upcoming {gitops-title} GA v1.10.0 release:
57+
+
58+
** The `.spec.sso.image`, `.spec.sso.version`, `.spec.sso.resources`, and `.spec.sso.verifyTLS` fields.
59+
** The `.spec.dex` parameter along with `DISABLE_DEX`.
60+
+
61+
The deprecated previous `sso` and `dex` fields were earlier scheduled for removal in the {gitops-title} v1.9.0 release but are now planned to be removed in the upcoming {gitops-title} GA v1.10.0 release.
62+
link:https://issues.redhat.com/browse/GITOPS-2904[GITOPS-2904]
63+
64+
[id="fixed-issues-1-9-0_{context}"]
65+
== Fixed issues
66+
The following issues have been resolved in the current release:
67+
68+
* Before this update, when the `argocd-server-tls` secret was updated with a new certificate Argo CD was not always picking up this secret. As a result, the old expired certificate was presented. This update fixes the issue with a new `GetCertificate` function and ensures that the latest version of certificates is in use. When adding new certificates, now Argo CD picks them up automatically without the user having to restart the `argocd-server` pod. link:https://issues.redhat.com/browse/GITOPS-2375[GITOPS-2375]
69+
70+
* Before this update, when enforcing GPG signature verification against a `targetRevision` integer pointing to a signed Git tag, users got a `Target revision in Git is not signed` error. This update fixes the issue and lets users enforce GPG signature verification against signed Git tags. link:https://issues.redhat.com/browse/GITOPS-2418[GITOPS-2418]
71+
72+
* Before this update, users could not connect to Microsoft Team Foundation Server (TFS) type Git repositories through Argo CD deployed by the Operator. This update fixes the issue by updating the Git version to
73+
2.39.3 in the Operator. link:https://issues.redhat.com/browse/GITOPS-2768[GITOPS-2768]
74+
75+
* Before this update, when the Operator was deployed and running with the High availability (HA) feature enabled, setting resource limits under the `.spec.ha.resources` field did not affect Redis HA pods. This update fixes the reconciliation by adding checks in the Redis reconciliation code. These checks ensure whether the `spec.ha.resources` field in the Argo CD custom resource (CR) is updated. When the Argo CD CR is updated with new CPU and memory requests or limit values for HA, now these changes are applied to the Redis HA pods. link:https://issues.redhat.com/browse/GITOPS-2404[GITOPS-2404]
76+
77+
* Before this update, if a namespace-scoped Argo CD instance was managing multiple namespaces by using the `managed-by` label and one of those managed namespaces was in a *Terminating* state, the Argo CD instance could not deploy resources to all other managed namespaces. This update fixes the issue by enabling the Operator to remove the `managed-by` label from any previously managed now terminating namespace. Now, a terminating namespace managed by a namespace-scoped Argo CD instance does not block the deployment of resources to other managed namespaces. link:https://issues.redhat.com/browse/GITOPS-2627[GITOPS-2627]
78+
79+
[id="known-issues-1-10_{context}"]
80+
== Known issues
81+
* Currently, the Argo CD does not read the Transport Layer Security (TLS) certificates from the path specified in the `argocd-tls-certs-cm` config map resulting in the `x509: certificate signed by unknown authority` error.
82+
+
83+
Workaround: Perform the following steps:
84+
85+
. Add the `SSL_CERT_DIR` environment variable:
86+
+
87+
.Example Argo CD custom resource
88+
89+
[source,yaml]
90+
----
91+
apiVersion: argoproj.io/v1alpha1
92+
kind: ArgoCD
93+
metadata:
94+
name: example-argocd
95+
labels:
96+
example: repo
97+
spec:
98+
...
99+
repo:
100+
env:
101+
- name: SSL_CERT_DIR
102+
value: /tmp/sslcertdir
103+
volumeMounts:
104+
- name: ssl
105+
mountPath: /tmp/sslcertdir
106+
volumes:
107+
- name: ssl
108+
configMap:
109+
name: user-ca-bundle
110+
...
111+
----
112+
113+
. Create an empty config map in the namespace where the subscription for your Operator exists and include the following label:
114+
+
115+
.Example config map
116+
117+
[source,yaml]
118+
----
119+
apiVersion: v1
120+
kind: ConfigMap
121+
metadata:
122+
name: user-ca-bundle <1>
123+
labels:
124+
config.openshift.io/inject-trusted-cabundle: "true" <2>
125+
----
126+
<1> Name of the config map.
127+
<2> Requests the Cluster Network Operator to inject the merged bundle.
128+
+
129+
After creating this config map, the `user-ca-bundle` content from the `openshift-config` namespace automatically gets injected into this config map, even merged with the system ca-bundle. link:https://issues.redhat.com/browse/GITOPS-1482[GITOPS-1482]

modules/go-compatibility-and-support-matrix.adoc

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ In {product-title} 4.13, the `stable` channel has been removed. Before upgrading
2323
|*OpenShift GitOps* 7+|*Component Versions*|*OpenShift Versions*
2424

2525
|*Version* |*`kam`* |*Helm* |*Kustomize* |*Argo CD*|*ApplicationSet* |*Dex* |*RH SSO* |
26+
|1.9.0 |0.0.49 TP |3.11.2 GA|5.0.1 GA |2.7.2 GA |NA |2.35.1 GA |7.5.1 GA |4.12-4.13
2627
|1.8.0 |0.0.47 TP |3.10.0 GA|4.5.7 GA |2.6.3 GA |NA |2.35.1 GA |7.5.1 GA |4.10-4.13
2728
|1.7.0 |0.0.46 TP |3.10.0 GA|4.5.7 GA |2.5.4 GA |NA |2.35.1 GA |7.5.1 GA |4.10-4.12
2829
|1.6.0 |0.0.46 TP |3.8.1 GA|4.4.1 GA |2.4.5 GA |GA and included in ArgoCD component |2.30.3 GA |7.5.1 GA |4.8-4.11
@@ -48,6 +49,14 @@ The features mentioned in the following table are currently in Technology Previe
4849
|====
4950
|Feature |TP in {gitops-title} versions|GA in {gitops-title} versions
5051

52+
|The custom `must-gather` tool
53+
|1.9.0
54+
|NA
55+
56+
|Argo Rollouts
57+
|1.9.0
58+
|NA
59+
5160
|ApplicationSet Progressive Rollout Strategy
5261
|1.8.0
5362
|NA

0 commit comments

Comments
 (0)