发布日期: 2026-09-14
版本号: v3.4.9

Argo CD v3.4.9 版本发布说明：安装方面，非高可用部署只需创建 argocd 命名空间并应用官方 install.yaml 清单，高可用部署则改用 ha/install.yaml 清单，均使用服务端应用并强制冲突模式。安全性方面，所有容器镜像均通过 cosign 签名，容器镜像与 CLI 二进制文件生成符合 SLSA Level 3 规范的来源证明，可在官方文档中查看验证方法。升级方面，若从其他次版本升级，务必先阅读官方升级文档，另有官方博客详细解读本版本的关键变更与改进。本次更新包含多项缺陷修复：KubeVirt 虚拟机声明为停止状态时正确判定为健康、FlinkDeployment 挂起时上报为健康、版本变更时正确清理仓库、Crossplane MR 在供应过程中上报为进行中而非健康、重试时正确设置 operationState 值、修复 SSO 重定向导致的 401 重试循环、修复 hydrateTo 分支名使用问题、GRPCRoute 健康检查忽略过期的 observedGeneration 条件，以及处理 GrafanaFolder 反极性条件。完整变更记录可对比 v3.4.8 与 v3.4.9 的提交历史。

更新内容 （中文）

快速开始

非高可用（Non-HA）：

kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.9/manifests/install.yaml

高可用（HA）：

kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.9/manifests/ha/install.yaml

发布签名与来源证明

所有 Argo CD 容器镜像均由 cosign 签名。对于符合 SLSA Level 3 规范的容器镜像和 CLI 二进制文件，会生成来源证明（Provenance）。验证方法请参阅文档。

发布说明博客文章

有关此版本关键变更和改进的详细解读，请查看官方博客文章

升级

如果从不同的次版本升级，请务必阅读升级文档。

更新日志

缺陷修复

  • b938a5e7238c5993534156acdd39953d0aab2bc0: fix(health): KubeVirt VirtualMachine 声明为 stopped 时判定为 Healthy（cherry-pick #29664 for 3.4）(#29666) (@argo-cd-cherry-pick-bot[bot])
  • 8d84b9380186ef6e1b694c718128ddb4b4cbb5ee: fix(health): 将已暂停的 FlinkDeployment 报告为 healthy (#26818) (cherry-pick #28995 for 3.4) (#29527) (@argo-cd-cherry-pick-bot[bot])
  • bfd48bd87729d1675509d89cf9eeb41d83d6a967: fix(repository): 修订版本变更时清理仓库 (cherry-pick #28771 for 3.4) (#29485) (@argo-cd-cherry-pick-bot[bot])
  • 4e0f6b78ce57547415eaac042a35a29f7fa0345c: fix(resource_customizations): Crossplane MR 在置备期间应报告 Progressing（而非 Healthy）[ISSUE: #29381] (cherry-pick #29382 for 3.4) (#29521) (@argo-cd-cherry-pick-bot[bot])
  • 182c837b67b7176e03342b19e0a7d23a4da347af: fix(sync): 重试时正确设置 operationState 值 (#26530) (cherry-pick #28778 for 3.4) (#29432) (@omkar619-dev)
  • ae7133151cd1ad803455a18a810c7a091de09b69: fix(ui): 保护 SSO 重定向以终止 401 重试循环 (cherry-pick #28807 for 3.4) (#29632) (@argo-cd-cherry-pick-bot[bot])
  • 38b5adf870e5aa0521a0a2e2638af11cf087a518: fix(ui): 设置时使用 hydrateTo 分支名称 (cherry-pick #29562 for 3.4) (#29566) (@crenshaw-dev)
  • fb9431d44e8f61fe0b156a1abb9289b9d85dbe2c: fix: GRPCRoute 健康检查忽略过期的 observedGeneration 条件 (#28086) (cherry-pick #28087 for 3.4) (#29518) (@argo-cd-cherry-pick-bot[bot])
  • 51edefdfb252547d408b70da03fceb78a3e0e387: fix: 处理 GrafanaFolder 负极性条件 (#29395) (cherry-pick #29397 for 3.4) (#29523) (@argo-cd-cherry-pick-bot[bot])

完整变更日志：https://github.com/argoproj/argo-cd/compare/v3.4.8…v3.4.9

更新内容 （原始）

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.9/manifests/install.yaml

HA:

kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.4.9/manifests/ha/install.yaml

Release 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

  • b938a5e7238c5993534156acdd39953d0aab2bc0: fix(health): a KubeVirt VirtualMachine declared stopped is Healthy (cherry-pick #29664 for 3.4) (#29666) (@argo-cd-cherry-pick-bot[bot])
  • 8d84b9380186ef6e1b694c718128ddb4b4cbb5ee: fix(health): report suspended FlinkDeployment as healthy (#26818) (cherry-pick #28995 for 3.4) (#29527) (@argo-cd-cherry-pick-bot[bot])
  • bfd48bd87729d1675509d89cf9eeb41d83d6a967: fix(repository): clean repository on revision change (cherry-pick #28771 for 3.4) (#29485) (@argo-cd-cherry-pick-bot[bot])
  • 4e0f6b78ce57547415eaac042a35a29f7fa0345c: fix(resource_customizations): Crossplane MRs should report Progressing (not Healthy) whilst provisioning [ISSUE: #29381] (cherry-pick #29382 for 3.4) (#29521) (@argo-cd-cherry-pick-bot[bot])
  • 182c837b67b7176e03342b19e0a7d23a4da347af: fix(sync): correctly set operationState values on retry (#26530) (cherry-pick #28778 for 3.4) (#29432) (@omkar619-dev)
  • ae7133151cd1ad803455a18a810c7a091de09b69: fix(ui): guard SSO redirect to stop 401 retry loop (cherry-pick #28807 for 3.4) (#29632) (@argo-cd-cherry-pick-bot[bot])
  • 38b5adf870e5aa0521a0a2e2638af11cf087a518: fix(ui): use hydrateTo branch name when set (cherry-pick #29562 for 3.4) (#29566) (@crenshaw-dev)
  • fb9431d44e8f61fe0b156a1abb9289b9d85dbe2c: fix: GRPCRoute health check ignores stale observedGeneration conditions (#28086) (cherry-pick #28087 for 3.4) (#29518) (@argo-cd-cherry-pick-bot[bot])
  • 51edefdfb252547d408b70da03fceb78a3e0e387: fix: handle GrafanaFolder negative-polarity condition (#29395) (cherry-pick #29397 for 3.4) (#29523) (@argo-cd-cherry-pick-bot[bot])

Full Changelog: https://github.com/argoproj/argo-cd/compare/v3.4.8...v3.4.9

下载链接