Releases: argoproj/argo-cd
v3.4.4
Quick Start
Non-HA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.4/manifests/install.yamlHA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.4/manifests/ha/install.yamlRelease Signatures and Provenance
All Argo CD container images are signed by cosign. A Provenance is generated for container images and CLI binaries which meet the SLSA Level 3 specifications. See the documentation on how to verify.
Release Notes Blog Post
For a detailed breakdown of the key changes and improvements in this release, check out the official blog post
Upgrading
If upgrading from a different minor version, be sure to read the upgrading documentation.
Changelog
Bug fixes
- 146184e: fix(health): PromotionStrategy stuck Progressing after no-op re-hydration (#28124) (cherry-pick #28125 for 3.4) (#28135) (@argo-cd-cherry-pick-bot[bot])
- e515f51: fix(rbac): resolve RBAC regression for project-scoped resources in multi-namespace architecture (#25289) (#26573) (#28062) (@wanddynosios)
- 7f2fe95: fix(ssd): regression causing diff to error on new objects (#27679) (cherry-pick #27703 for 3.4) (#28241) (@argo-cd-cherry-pick-bot[bot])
- 5199ea6: fix: add a lock on clusterinformer (cherry-pick #28216 for 3.4) (#28312) (@blakepettersson)
- 7a64081: fix: exclude live status from normalization (cherry-pick #28201 for 3.4) (#28204) (@argo-cd-cherry-pick-bot[bot])
- 0b3436f: fix: fixes parsing of dex passwords with dollar sign (cherry pick of #28027 to 3.4) (#28197) (@ppapapetrou76)
- 9ccf66b: fix: resolve cross-generator Values templates in RenderGeneratorParams (#27827) (cherry-pick #27830 for 3.4) (#28128) (@argo-cd-cherry-pick-bot[bot])
Other work
- 14ad471: Merge pull request #28162 from argoproj/cherry-pick-28158-to-release-3.4 (@dudinea)
- 0fd000b: Merge pull request #28164 from argoproj/cherry-pick-28155-to-release-3.4 (@dudinea)
- ff25519: chore(ci): bump codecov action to 7.0.0 to fix the GPG issue (cherry-pick #28159 for 3.4) (#28172) (@dudinea)
- e9ff0c5: ci: bump goreleaser (cherry-pick #28033 for 3.4) (#28072) (@argo-cd-cherry-pick-bot[bot])
- 1c5e37d: ci: use github release notes in goreleaser (cherry-pick #28048 for 3.4) (#28071) (@argo-cd-cherry-pick-bot[bot])
- 0c14cfb: fix(manifest-generate-paths): Normalize repo before using type repo (#28113) (@fm1ck3y)
- c2003f4: test(e2e): Add test for second Sync after initial for different resources/options (#28156) (#28155) (@dudinea)
- 9810fa2: test(e2e): fix cleanup of CRDs for e2e tests (#28157) (#28158) (@dudinea)
Full Changelog: v3.4.3...v3.4.4
v3.3.12
Quick Start
Non-HA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.3.12/manifests/install.yamlHA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.3.12/manifests/ha/install.yamlRelease Signatures and Provenance
All Argo CD container images are signed by cosign. A Provenance is generated for container images and CLI binaries which meet the SLSA Level 3 specifications. See the documentation on how to verify.
Release Notes Blog Post
For a detailed breakdown of the key changes and improvements in this release, check out the official blog post
Upgrading
If upgrading from a different minor version, be sure to read the upgrading documentation.
Changelog
Bug fixes
- 47da184: fix(health): PromotionStrategy stuck Progressing after no-op re-hydration (#28124) (cherry-pick #28125 for 3.3) (#28136) (@argo-cd-cherry-pick-bot[bot])
- e385760: fix: add a lock on clusterinformer (cherry-pick #28216 for 3.3) (#28313) (@blakepettersson)
- 516314b: fix: exclude live status from normalization (cherry-pick #28201 for 3.3) (#28203) (@argo-cd-cherry-pick-bot[bot])
- 3205f8b: fix: fixes parsing of dex passwords with dollar sign (cherry pick of #28027 to 3.3 (#28198) (@ppapapetrou76)
- 703ad3f: fix: honor repo depth setting in gitSourceHasChanges and fetch functions (cherry-pick #27838 for 3.3) (#28065) (@alexandresavicki)
Other work
- c4c07e3: Merge pull request #28161 from argoproj/cherry-pick-28158-to-release-3.3 (@dudinea)
- cdfc9a5: Merge pull request #28166 from argoproj/cherry-pick-28155-to-release-3.3 (@dudinea)
- 6aecd33: chore(ci): bump codecov action to 7.0.0 to fix the GPG issue (cherry-pick #28159 for 3.3) (#28173) (@dudinea)
- b9f2a3b: test(e2e): Add test for second Sync after initial for different resources/options (#28156) (#28155) (@dudinea)
- fe3fea2: test(e2e): fix cleanup of CRDs for e2e tests (#28157) (#28158) (@dudinea)
Full Changelog: v3.3.11...v3.3.12
v3.5.0-rc1
Quick Start
Non-HA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.5.0-rc1/manifests/install.yamlHA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.5.0-rc1/manifests/ha/install.yamlRelease Signatures and Provenance
All Argo CD container images are signed by cosign. A Provenance is generated for container images and CLI binaries which meet the SLSA Level 3 specifications. See the documentation on how to verify.
Release Notes Blog Post
For a detailed breakdown of the key changes and improvements in this release, check out the official blog post
Upgrading
If upgrading from a different minor version, be sure to read the upgrading documentation.
Changelog
Features
- be19446: feat(Jitter): Add Configurable Jitter for Webhook-Triggered application Refreshes (#25433) (@adityaraj178)
- 5b30739: feat(appset): add concurrency when managing applications (#26642) (@rumstead)
- 29fd8db: feat(appset): filtering repos by archived status #20736 (#21505) (@prune998)
- 57942ce: feat(cli): Add support for Source Integrity configuration (#26997) (@olivergondza)
- 3cc6ba7: feat(cli): add --app-namespace flag to missing argocd app subcommands (#27942) (@Mangaal)
- 0e729cc: feat(cli): add appset-namespace for appset command (#27022) (@Mangaal)
- 744983b: feat(health): Add healthcheck for gardener "Shoot" resources (#25750) (@Sven1410)
- 6cc786d: feat(health): add GatewayClass health check (#26591) (@dnfwlq8054)
- eabd4d6: feat(health): add pause and unpause actions to psmdb resource (#27616) (@KyriosGN0)
- daadf86: feat(health): additional promoter.argoproj.io health checks (#27170) (@crenshaw-dev)
- 4b69a7f: feat(health): finalizer messages for Promoter checks (#27478) (@crenshaw-dev)
- 289a4c0: feat(health): support BackendTLSPolicy.gateway.networking.k8s.io (#27385) (@snorwin)
- 4cdc650: feat(helm): support wildcard glob patterns for
valueFiles(#26768) (@nitishfy) - f7a7deb: feat(hydrator): dynamically manage README template from argocd-cm ConfigMap [updated] (#19067) (#24309) (@gyu-young-park)
- 86936e2: feat(hydrator): make manifest hydration queue concurrency configurable (#27926) (#27948) (@GuruduGanesh)
- 2308e17: feat(hydrator): opt-in source integrity verification for dry sources (Alpha) (#19302) (#28084) (@mladjan-gadzic)
- bf1591d: feat(hydrator): support syncSource repoURL for separate destination repo (#27011) (@boostrack)
- 0c0140c: feat(metrics): add parallelism limit repo server (#27911) (@pjiang-dev)
- 7d2eb77: feat(renovate): clean up config and remove github app (#27738) (@rumstead)
- 153ec67: feat(resource_customizations): add health checks for VictoriaMetrics (#27451) (@megative)
- 6b84ea9: feat(server): drop objects from non-allowed namespaces before they enter the cache. (#28018) (@christianh814)
- 224b75a: feat(server): use typed Argo CD EventList for event-listing APIs (#25767) (#26322) (@chansuke)
- 64a0417: feat(ui): Add AppSet to Application Resource Tree (#26601) (@pjiang-dev)
- b035a77: feat(ui): ApplicationSet Preview Apps tab in UI (#27799) (@pjiang-dev)
- 566c172: feat(ui): add GitOps Promoter resource icon (#26894) (@crenshaw-dev)
- 0dd8874: feat(ui): add nauth.io resource icon (#28226) (@choufraise)
- f16d08a: feat(ui): add repo url as filter in home page (#26670) (#27418) (@adityaraj178)
- 91e7664: feat(ui): per-application notice banner and info icon (#14405) (#27719) (@gdsoumya)
- 1b405ce: feat(ui): search filter by target revision (#24038) (@choejwoo)
- 706a037: feat(ui): support creating multi-source applications in New App panel
[CONTINUED..](#27095) (@aali309) - 2fcf104: feat(ui): support spec.sourceHydrator.drySource.repoURL (@crenshaw-dev)
- 74d1fe0: feat(ui): use toggle-auto-sync resource action in app details page (#21564) (#27226) (@shiiyan)
- db7d672: feat(webhooks): add webhook support for GHCR (#26462) (@nitishfy)
- 6d92e17: feat: Add ProvideClusterInfo and Config fields to ExecProviderConfig (#24282) (#27976) (@mikeshng)
- 022f935: feat: Add basic support for git tag path prefixes (#27290) (@k4r1)
- aad3422: feat: Add suspend/resume actions for MariaDB (#27675) (#27674) (@mgross2)
- 586430c: feat: Migrate from Helm 3 to Helm 4 (#28076) (@reggie-k)
- c61c1dc: feat: Render Helm ValuesObject as YAML in log output instead of binary (#18342) (#27649) (@subhramit)
- 9a19735: feat: Support Azure Service Principal authentication for Azure DevOps repositories (#25324) (@allanyung)
- 97082e8: feat: add Gateway API support to network view (#26188) (@tete17)
- 603c900: feat: add action to delete recyclable Numaflow pipelines (#25900) (@dpadhiar)
- de94161: feat: add action to restart StrimziPodSet (#27266) (@KyriosGN0)
- a2b91ce: feat: add depth option to ui (#26618) (@blakepettersson)
- 1dc2ad0: feat: add health check for karpenter.sh/NodeClaim (#26876) (@Navneet072300)
- 611fcb0: feat: add sync overrun option to sync windows (#25361) (#25510) (@puskunalis)
- 48f18e2: feat: add toggle-auto-sync resource action for Application (#21564) (#26477) (@vikasrao23)
- 2df5f75: feat: adds mTLS support in repo-server (#26715) (@ppapapetrou76)
- 4d02fc2: feat: expose Appset UI and fix pie chart summary (#26666) (@pjiang-dev)
- a889f46: feat: make appset proxy-url param a native flag (#27788) (@ppapapetrou76)
- ad310c2: feat: replace error message in webhook handler with metrics (#27215) (@alexmt)
- 01187d1: feat: support Azure AD groups claims overflow via Microsoft Graph API (#27397) (@gravufo)
- f71239c: feat: support destinationServiceAccounts in global projects (#23059) (@enneitex)
- f460a3c: feat: surface root cause in sync failure message and cache discovery errors (#27750) (@ppapapetrou76)
- 3eebbcb: feat: use impersonation for server operations (logs, delete, etc) #22996 (#26898) (@alexymantha)
Bug fixes
- b982144: Revert "fix: prevent automatic refreshes from informer resync and status updates" (#27562) (@agaudreault)
- c5d1c91: fix(UI): show RollingSync step clearly when labels match no step (#26877) (@aali309)
- c52bf66: fix(appcontroller): application controller in core mode fails to sync when server.secretkey is missing (#26793) (@anandf)
- e81969f: fix(applicationset): include repo URL in git file generator errors (#28075) (@morning-verlu)
- 45a84df: fix(ci): add .gitkeep to images dir (#26892) (@blakepettersson)
- 4c42071: fix(ci): openssf scorecard doesn't allow global vars (#27203) (@crenshaw-dev)
- 36f4ff7: fix(ci): pin goreman version used in ci-build.yaml (#27062) (#27061) (@dudinea)
- 25b3037: fix(ci): pnpm sbom generation (#27337) (#27339) (@crenshaw-dev)
- 99c51df: fix(ci): renovatebot action uses floating image tag (#27023) (#27024) (@dudinea)
- fb82b16: fix(ci): run yarn install with --frozen-lockfile (#27098) (#27099) (@dudinea)
- b403f5c: fix(cli): hide unsupported --tls-server-name kubectl REST flag (#27694) (#27711) (@SAY-5)
- 60b878d: fix(cli): hide unsupported kubectl REST flags (#25875) (#25977) (@HyejunKoo)
- 21fe1fb: fix(cli): honor --kube-context when creating core-mode REST config (#12883) (#27661) (@ystkfujii)
- 52f7b3b: fix(cli): print clear timeout message when argocd app wait times out (#28274) (@pncloud)
- f48091a: fix(cli): return immediately from 'app wait' when app is already in desired state (#12211) (#27503) (@jheyduk)
- 6256...
v3.4.3
Quick Start
Non-HA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.3/manifests/install.yamlHA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.3/manifests/ha/install.yamlRelease Signatures and Provenance
All Argo CD container images are signed by cosign. A Provenance is generated for container images and CLI binaries which meet the SLSA Level 3 specifications. See the documentation on how to verify.
Release Notes Blog Post
For a detailed breakdown of the key changes and improvements in this release, check out the official blog post
Upgrading
If upgrading from a different minor version, be sure to read the upgrading documentation.
Changelog
Bug fixes
- f435b0f fix(cli): return immediately from 'app wait' when app is already in desired state (#12211) (#27503) (#27713) (jheyduk)
- b39fe4f fix(lint): unnecessary nesting (cherry-pick #27815 for 3.4) (#27817) (argo-cd-cherry-pick-bot[bot], Michael Crenshaw)
- 668f2c5 fix(ui): don't prefetch errors (#27877) (cherry-pick #27925 for 3.4) (#28024) (argo-cd-cherry-pick-bot[bot], Blake Pettersson)
- b796979 fix(ui): return full source for non-hydrator apps in Parameters tab (cherry-pick #26946 for 3.4) (#27964) (Gabriel Barreto, himeshp)
- 5d3f8a0 fix: honor repo depth setting in gitSourceHasChanges and fetch functions (cherry-pick #27838 for 3.4) (#28043) (argo-cd-cherry-pick-bot[bot], alexandresavicki, Cursor)
- 35ed877 fix: nil-check (cherry-pick #28039 for 3.4) (#28040) (argo-cd-cherry-pick-bot[bot], Blake Pettersson, Soumya Ghosh Dastidar)
- b0f1553 fix: prevent InvalidSpecError race in application controller startup (cherry-pick #27672 for 3.4) (#27845) (argo-cd-cherry-pick-bot[bot], Michele Baldessari)
- 4fa0950 fix: truncate labels for deletion hook resources (cherry-pick #27542 for 3.4) (#27714) (argo-cd-cherry-pick-bot[bot], Jaewoo Choi)
Dependency updates
- 0edd404 chore(deps): bump redoc/dompurify to v3.4.0 in /ui for fixing CVE-2026-41240(cherry-pick 3.4) (#27913) (Alka Kumari)
Other work
- ce55c85 fix(gitops-engine): fix nil pointer dereference error in removeWebookMutation() (cherry-pick #27749 for 3.4) (#28031) (argo-cd-cherry-pick-bot[bot], Pierre Guinoiseau)
Full Changelog: v3.4.2...v3.4.3
v3.3.11
Quick Start
Non-HA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.3.11/manifests/install.yamlHA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.3.11/manifests/ha/install.yamlRelease Signatures and Provenance
All Argo CD container images are signed by cosign. A Provenance is generated for container images and CLI binaries which meet the SLSA Level 3 specifications. See the documentation on how to verify.
Release Notes Blog Post
For a detailed breakdown of the key changes and improvements in this release, check out the official blog post
Upgrading
If upgrading from a different minor version, be sure to read the upgrading documentation.
Changelog
Bug fixes
- cd3b64d: fix(lint): unnecessary nesting (cherry-pick #27815 for 3.3) (#27818) (@argo-cd-cherry-pick-bot[bot])
- 82dd8ce: fix(ui): don't prefetch errors (#27877) (cherry-pick #27925 for 3.3) (#28023) (@argo-cd-cherry-pick-bot[bot])
- da10473: fix: nil-check (cherry-pick #28039 for 3.3) (#28041) (@argo-cd-cherry-pick-bot[bot])
- d556067: fix: prevent InvalidSpecError race in application controller startup (cherry-pick #27672 for 3.3) (#27844) (@argo-cd-cherry-pick-bot[bot])
- 21d5538: fix: remove resourceVersion from ssd (#27406) (cherry-pick release-3.3) (#28016) (@blakepettersson)
- 120eb31: fix: truncate labels for deletion hook resources (cherry-pick #27542 for 3.3) (#27715) (@choejwoo)
Dependency updates
- 1cb5892: chore(deps): bump redoc/dompurify to v3.4.0 in /ui for fixing CVE-2026-41240(cherry-pick 3.3) (#27912) (@alkakumari016)
Other work
- 9e25303: fix(gitops-engine): fix nil pointer dereference error in removeWebookMutation() (cherry-pick #27749 for 3.3) (#28032) (@argo-cd-cherry-pick-bot[bot])
Full Changelog: v3.3.10...v3.3.11
v3.2.12
Quick Start
Non-HA:
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.2.12/manifests/install.yamlHA:
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.2.12/manifests/ha/install.yamlRelease Signatures and Provenance
All Argo CD container images are signed by cosign. A Provenance is generated for container images and CLI binaries which meet the SLSA Level 3 specifications. See the documentation on how to verify.
Release Notes Blog Post
For a detailed breakdown of the key changes and improvements in this release, check out the official blog post
Upgrading
If upgrading from a different minor version, be sure to read the upgrading documentation.
Changelog
Bug fixes
- 2d1a0bb: fix(lint): unnecessary nesting (cherry-pick #27815 for 3.2) (#27819) (@argo-cd-cherry-pick-bot[bot])
- 4caf270: fix: export url validation function (#27816) (@crenshaw-dev)
- d6e96fc: fix: wrap lines toggle causes log lines to overflow container - Fixes [Issue #27586] (cherry-pick #27627 for 3.2) (#27668) (@argo-cd-cherry-pick-bot[bot])
Dependency updates
- cff8c03: chore(deps): bump github.com/moby/spdystream from 0.5.0 to 0.5.1 (cherry-pick #27401 for 3.2) (#27735) (@argo-cd-cherry-pick-bot[bot])
Other work
- 3f7237b: Merge commit from fork (@pjiang-dev)
- c8df5ff: Merge commit from fork (@blakepettersson)
Full Changelog: v3.2.11...v3.2.12
v3.4.2
Quick Start
Non-HA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.2/manifests/install.yamlHA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.2/manifests/ha/install.yamlRelease Signatures and Provenance
All Argo CD container images are signed by cosign. A Provenance is generated for container images and CLI binaries which meet the SLSA Level 3 specifications. See the documentation on how to verify.
Release Notes Blog Post
For a detailed breakdown of the key changes and improvements in this release, check out the official blog post
Upgrading
If upgrading from a different minor version, be sure to read the upgrading documentation.
Changelog
Bug fixes
- b15e9e3 fix: Revert "fix: avoid calling UpdateRevisionForPaths unnecessary (#25151)" (cherry-pick #27241 for 3.4) (#27251) (argo-cd-cherry-pick-bot[bot], Alexander Matyushentsev)
- 570ccbc fix: prevent panic on nil APIResource in permission validator (cherry-pick #26610 for 3.4) (#27752) (argo-cd-cherry-pick-bot[bot], Andy Lo-A-Foe)
Dependency updates
- 6eb6215 chore(deps): bump github.com/moby/spdystream from 0.5.0 to 0.5.1 (cherry-pick #27401 for 3.4) (#27734) (argo-cd-cherry-pick-bot[bot], dependabot[bot])
Other work
- 35ea43c Merge commit from fork (Blake Pettersson)
- bcb4298 Merge commit from fork (Peter Jiang)
- 4e71577 chore: bump otel/sdk to 1.43.0 (release-3.4) (#27806) (Nitish Kumar)
- 6e227ba ci: pin images of setup-qemu-action, setup-buildx-action and goreleaser CLI version (cherry-pick #27060 for 3.4) (#27731) (argo-cd-cherry-pick-bot[bot], Regina Voloshin)
- 87e9148 fix(gitops-engine): apply HideSecretData to server-side diff results for Secrets (cherry-pick #27598 for 3.4) (#27754) (argo-cd-cherry-pick-bot[bot], Peter Jiang, downfa11)
Full Changelog: v3.4.1...v3.4.2
v3.3.10
Quick Start
Non-HA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.3.10/manifests/install.yamlHA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.3.10/manifests/ha/install.yamlRelease Signatures and Provenance
All Argo CD container images are signed by cosign. A Provenance is generated for container images and CLI binaries which meet the SLSA Level 3 specifications. See the documentation on how to verify.
Release Notes Blog Post
For a detailed breakdown of the key changes and improvements in this release, check out the official blog post
Upgrading
If upgrading from a different minor version, be sure to read the upgrading documentation.
Changelog
Bug fixes
- eb947bf: fix: prevent panic on nil APIResource in permission validator (cherry-pick #26610 for 3.3) (#27753) (@argo-cd-cherry-pick-bot[bot])
- 7b8c7be: fix: wrap lines toggle causes log lines to overflow container - Fixes [Issue #27586] (cherry-pick #27627 for 3.3) (#27671) (@argo-cd-cherry-pick-bot[bot])
Other work
- 7879e63: Merge commit from fork (@pjiang-dev)
- 00f83c4: Merge commit from fork (@blakepettersson)
- d7f8ba1: chore: align Go versions across Dockerfiles and downgrade Go version in go.mod (#27808) (@reggie-k)
- 5c7eb8f: chore: bump otel/sdk to 1.43.0 (release-3.3) (#27807) (@nitishfy)
- 7830a12: chore: update Go to 1.25.9 on release-3.3 to resolve CVEs (#27639) (#27656) (@ihmdika)
- ac11bec: fix(gitops-engine): apply HideSecretData to server-side diff results … (#27762) (@pjiang-dev)
Full Changelog: v3.3.9...v3.3.10
v3.4.1
Important
This release is the first one in the 3.4 series, although it is not named 3.4.0.
Important
Following Helm 3.19.0 change in how Helm interprets K8s cluster version, this Argo CD release contains a change that aligns how Argo CD interprets K8s cluster version with Helm behavior.
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 vMajor.Minor.Patch format instead of the previous Major.Minor format.
More details here: https://argo-cd.readthedocs.io/en/stable/operator-manual/upgrading/3.3-3.4/#cluster-version-format-change
Quick Start
Non-HA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.1/manifests/install.yamlHA:
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.1/manifests/ha/install.yamlRelease Signatures and Provenance
All Argo CD container images are signed by cosign. A Provenance is generated for container images and CLI binaries which meet the SLSA Level 3 specifications. See the documentation on how to verify.
Release Notes Blog Post
For a detailed breakdown of the key changes and improvements in this release, check out the official blog post
Upgrading
If upgrading from a different minor version, be sure to read the upgrading documentation.
Changelog
Features
- 05504d6 feat(appset): add Health field to ApplicationSet status (#25753) (Peter Jiang)
- f83906d feat(appset): optimize appset controller performance when grabbing cluster secrets (#25624) (#25577) (rumstead)
- ed6d2c5 feat(controller): Annotation to pause reconciliation for a specific cluster (#26442) (Drew Bailey, Drew Bailey)
- 3157fb1 feat(helm): support wildcard glob patterns for
valueFiles(cherry-pick #26768 for 3.4) (#26919) (argo-cd-cherry-pick-bot[bot], Nitish Kumar) - 5072899 feat(hydrator): making configurable authorName/Email used for hydration commit (#22847) (#25746) (Aditya Raj)
- 8ed52b2 feat(notification): add appProject access to notification templates (#26437) (#26470) (Aditya Raj)
- e1aeb79 feat(ui): AppSet Slide Out Summary (#26490) (Peter Jiang, reggie-k)
- 5ab598e feat(ui): add annotation filtering support to applications list (#25590) (Ji Kwan)
- 1391e2f feat(ui): add appset tree-view details page (#26262) (Peter Jiang, reggie-k, Keith Chong)
- 7208578 feat(ui): appset list page and filters (#25837) (Peter Jiang)
- ff45972 feat(ui): enable hydrator support in app create panel (#26485) (jwinters01, Alexandre Gaudreault)
- 1214946 feat(ui): support hydrator properties in summary tab (#26152) (jwinters01, Michael Crenshaw)
- b414432 feat: Add application filter for operation status to UI (#25636) (Dylan Schlager)
- 408e99e feat: Allow custom User-Agent headers for Helm repository requests (#25473) (Yugan)
- 19b41b9 feat: ApplicationSet watch API (#26409) (Peter Jiang, nitishfy)
- b442167 feat: Document and expose K8S API client environment variables(#8527) (#25145) (gami, Alexandre Gaudreault)
- 7a3d6f1 feat: Implement nmstate health checks (#26506) (#26507) (Sander Tervoert)
- 5859065 feat: add ApplicationSet listResourceEvents API (#25537) (Peter Jiang, Alexy Mantha)
- 2793097 feat: add OTEL instrumentation for authentication and handlers (#25296) (Mike Cutsail, Alexandre Gaudreault)
- b7e2027 feat: add Prune and Delete as application level sync option (#23370) (Arthur Outhenin-Chalandre)
- 73b4d98 feat: add
--no-install-recommendsinargocd-base#25841 (#25852) (Jakub Rudnik, Nitish Kumar) - 13bc5ae feat: add argocd account session-token command (#15277) (#24638) (Alex Eftimie, Alexandre Gaudreault, Peter Jiang)
- d8635ca feat: add clear-all button to applications list filters (#26007) (Jaewoo Choi)
- c2e594c feat: disable gRPC service config DNS TXT lookups by default (#26077) (Valentin Stoican, Valentin Stoican)
- 3cb4955 feat: expose notifications controller processors count via cmd params (#26798) (Kirill Bilchenko)
- c0a2a57 feat: implement application cache synchronization in appset controller (#26578) (Alexander Matyushentsev)
- ef75a2e feat: limit max certificates and known hosts in stream parsing (#25777) (Ankit Pramanik)
- f85ad11 feat: remove unused reposFilter from Applications list (#24667) (Jaewoo Choi)
- 6f0de8b feat: update health checks for Numaflow resources (#25698) (Dillen Padhiar)
Bug fixes
- 9fd02aa Revert "fix: prevent automatic refreshes from informer resync and status updates (cherry-pick #25290 for 3.4)" (#27402) (Michael Crenshaw)
- f4e7a6e [release-3.4] fix: improve perf: switch parentUIDToChildren to map of sets, remove cache rebuild (#26863) (#27110) (Jonathan Ogilvie)
- 21e13a6 fix(UI): show RollingSync step clearly when labels match no step (cherry-pick #26877 for 3.4) (#26882) (argo-cd-cherry-pick-bot[bot], Atif Ali)
- ede9229 fix(actions): Use correct annotation for CNPG suspend/resume (#26711) (Rouke Broersma)
- 6665f94 fix(appcontroller): application controller in core mode fails to sync when server.secretkey is missing (#26793) (#27476) (Anand Francis Joseph)
- f45ee22 fix(appset): change appset resource status count to 5000 by default (#26249) (Peter Jiang)
- bb894e8 fix(appset): do not trigger reconciliation on appsets not part of allowed namespaces when updating a cluster secret (#25622) (OpenGuidou)
- 330077c fix(appset): fix post-generator selector ignoring labels in GoTemplate mode (#26717) (Josef Kolář)
- bdc3447 fix(appset): update appset resources after creation (#26511) (Peter Jiang)
- 59f229b fix(ci): Add missing git-lfs installer checksum for ppc64le (#26835) (Oliver Gondža)
- cbc7ecd fix(ci): Inconsistent use of IMAGE_REGISTRY and IMAGE_NAMESPACE Makefile variables (#25846) (#25860) (dudinea)
- 2253481 fix(ci): Remove stale label when Issue/PR is updated (#26452) (S Kevin Joe Harris)
- e70034a fix(ci): add .gitkeep to images dir (cherry-pick #26892 for 3.4) (#26912) (argo-cd-cherry-pick-bot[bot], Blake Pettersson)
- 4a5d3a7 fix(ci): add gitops-engine unit tests to CI (#25863) (Peter Jiang)
- 92c5389 fix(ci): ensure cherry-pick commits include DCO sign-off (#26124) (Anagha S Devan)
- aadf2af fix(ci): fix deleting files on linux in make build-ui (#26134) (#26135) (dudinea)
- 946a3ab fix(ci): fix make image DEV_IMAGE=true on non-amd64 architecture (#25897) (#25898) (dudinea, Nitish Kumar)
- b7f9f6d fix(ci): run yarn install with --frozen-lockfile (cherry-pick #27099 for 3.4) (#27350) (dudinea)
- a19a83a fix(cli): uses DrySource revision for app diff/manifests with sourceHydrator (#23817) (cherry-pick #24670 for 3.4) (#27483) (argo-cd-cherry-pick-bot[bot], Aditya Raj)
- 956a6a1 fix(controller): handle comma-separated hook annotations for PreDelete/PostDelete hooks (#26420) (Linghao Su)
- f50abb6 fix(controller): reduce secret deepcopies and deserialization (#27049) (cherry-pick release-3.4) (#27132) (rumstead)
- af05c56 fix(dashboards): Correct job label for the Controller Telemetry Panel (#26548) (Daniel Barnes)
- 986cdf0 fix(dev): skip Tilt rebuild on test file changes (#26624) (Nitish Kumar)
- 63698bd fix(dex): run as user 1001 (#26726) (#26757) (Michael Crenshaw)
- 8a507b7 fix(dex): run as user 1001 (#26726) (#26775) (Michael Crenshaw)
- 99e29c7 fix(docs): Fix manifest path in Source Hydrator docs (cherry-pick #27123 for 3.4) (#27166) (argo-cd-cherry-pick-bot[bot], Oliver Gondža)
- 3eeebd8 fix(docs): PR title guide from refactor to chore and reformat json (#26450) (Jaewoo Choi)
- d66ad45 fi...
v3.1.16
Important
END OF LIFE NOTICE
This is the final release of the 3.1 release series. As of May 06th 2026, this version has reached end of life and will no longer receive bug fixes or security updates.
Action Required:
Please upgrade to a supported version (v3.4, v3.3 or v3.2).
Quick Start
Non-HA:
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.1.16/manifests/install.yamlHA:
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.1.16/manifests/ha/install.yamlRelease Signatures and Provenance
All Argo CD container images are signed by cosign. A Provenance is generated for container images and CLI binaries which meet the SLSA Level 3 specifications. See the documentation on how to verify.
Release Notes Blog Post
For a detailed breakdown of the key changes and improvements in this release, check out the official blog post
Upgrading
If upgrading from a different minor version, be sure to read the upgrading documentation.
Changelog
Bug fixes
- af7a36e: fix(server): Avoid error when attempting a second delete operation (cherry-pick #27495 for 3.1) (#27502) (@argo-cd-cherry-pick-bot[bot])
Dependency updates
- c4499a3: chore(deps): bump SonarSource/sonarqube-scan-action from 5.2.0 to 8.0.0 (cherry-pick 27602 to 3.1) (#27607) (@dudinea)
Full Changelog: v3.1.15...v3.1.16
