docs: updated upgrade guide 3.3-3.4 and cluster generator doc with the changed cluster version format (#26837)

Signed-off-by: reggie-k <regina.voloshin@codefresh.io>
This commit is contained in:
Regina Voloshin 2026-03-16 03:45:50 +02:00 committed by GitHub
parent f0c694d9f0
commit f7dbfbd9b4
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 25 additions and 3 deletions

View file

@ -152,14 +152,14 @@ spec:
- clusters:
selector:
matchLabels:
argocd.argoproj.io/kubernetes-version: 1.28
argocd.argoproj.io/kubernetes-version: 1.28.1
# matchExpressions are also supported.
#matchExpressions:
# - key: argocd.argoproj.io/kubernetes-version
# operator: In
# values:
# - "1.27"
# - "1.28"
# - "1.27.1"
# - "1.28.1"
```
### Pass additional key-value pairs via `values` field

View file

@ -1,5 +1,27 @@
# v3.3 to 3.4
## Breaking Changes
### Cluster version format change
**New behavior:**
3.4 now stores the cluster version in a more detailed format, `Major.Minor.Patch` compared to the previous format `Major.Minor`.
This change is aligning how ArgoCD interprets K8s cluster version with how Helm `3.19.0` and above interprets it.
This change makes it easier to compare versions and to support future features. It also allows for more accurate version comparisons and better compatibility with future Kubernetes releases.
This change was also back ported to Argo CD `3.3.3`.
**Impact:**
Application Sets with Cluster Generators, that fetch clusters based on their Kubernetes version and use `argocd.argoproj.io/auto-label-cluster-info` on the cluster secret, need to be updated to use `argocd.argoproj.io/kubernetes-version` with the `Major.Minor.Patch` format instead of the previous `Major.Minor` format.
More details [here](../applicationset/Generators-Cluster.md#fetch-clusters-based-on-their-k8s-version).
Additionally, API, UI and CLI commands that retrieve cluster information now return the version in the `Major.Minor.Patch` format.
## Behavioral Improvements / Fixes
### Applications with `Missing` health status