发布日期: 2026-08-12
版本号: v3.5.1

这是Argo CD v3.5.1版本的发布信息，主要包含以下内容：可以通过执行kubectl命令创建namespace并应用指定的YAML文件来完成非高可用或高可用模式的快速安装。所有发布的容器镜像均已使用cosign进行签名，并生成了符合SLSA Level 3规范的来源证明。如果从不同次版本进行升级，需要参考升级文档。本次更新包含多项错误修复，例如解决了ApplicationSet的同步循环问题、终止应用的验证问题、控制器中超时重试的处理、Secret数据的差异计算缓存复用以及防止SSD CLI Secret掩码欺骗等。同时，还进行了版本号提升和清单生成路径缓存键的一致性修复等其他工作。完整的变更日志可通过提供的链接查看。

更新内容 （中文）

快速入门

非高可用模式：

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

高可用模式：

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

发布签名与来源信息

所有 Argo CD 容器镜像均由 cosign 签名。对于符合 SLSA Level 3 规范的容器镜像和 CLI 二进制文件，会生成一份来源证明。详情请参阅文档了解如何验证。

发布说明博文

有关本次发布中关键变更和改进的详细分解，请查阅官方博文。

升级说明

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

更新日志

错误修复

  • 33f3bc59faeec96204cda3a5ae211be17d15f1ac: 修复(appset): 停止渐进式同步在紧密循环中调和 (#27577) (#29139) (@himeshp)
  • d358e75b3539c3fc43eb2372317bde7a0d01c55f: 修复(appset): 通过 API 服务器验证正在终止的应用程序 (#29042) (#29138) (@himeshp)
  • ecf37373a9d3a72b259a73abfee7ce27226b960a: 修复(controller): 将 timeout.reconciliation=0 视为禁用软过期的移植修复 (#27683) (#29007) (@aali309)
  • 978fa65006565baaaf35894918fd661d610f5953: 修复(controller): 在屏蔽 Secret 数据时复用服务器端差异结果 (#27858) (#29074) (@1ovsss)
  • f399c84f85fc4e3a19ac1e8314ff111493d26fee: 修复(controller): 当 timeout.reconciliation 被禁用时使用差异缓存（为 3.5 版本移植 #29073）(#29158) (@argo-cd-cherry-pick-bot[bot])
  • 960bed7f2efcdc8b43fe392dd6d17cf95507c9f2: 修复(server): 防止 SSD CLI secret 屏蔽欺骗（为 3.5 版本移植 #29089）(#29130) (@argo-cd-cherry-pick-bot[bot])
  • 9f360f4953a1dc0f3474aa9c482d72366863ea33: 修复(ssd): 在 last-applied-configuration 注解中隐藏 secret (#28989) (#29052) (@pjiang-dev)

其他工作

  • 109ca7ca71139e514114499d294a492e7910a965: 任务: 在 release-3.5 分支上将版本号提升至 3.5.1 (#29165) (@github-actions[bot])
  • b44fbbc2e040e303c18a69182fd5dbe2c36cfdf9: 修复(manifest-generate-paths): 生成清单的缓存键保持一致 (#28074 和 #29037) (#29049) (@agaudreault)

完整更新日志: https://github.com/argoproj/argo-cd/compare/v3.5.0...v3.5.1

更新内容 （原始）

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.1/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.5.1/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

  • 33f3bc59faeec96204cda3a5ae211be17d15f1ac: fix(appset): stop progressive sync reconciling in a tight loop (#27577) (#29139) (@himeshp)
  • d358e75b3539c3fc43eb2372317bde7a0d01c55f: fix(appset): verify terminating Applications against the API server (#29042) (#29138) (@himeshp)
  • ecf37373a9d3a72b259a73abfee7ce27226b960a: fix(controller): cherry-pick treat timeout.reconciliation=0 as disabled soft expiry (#27683) (#29007) (@aali309)
  • 978fa65006565baaaf35894918fd661d610f5953: fix(controller): reuse server-side diff result when masking Secret data (#27858) (#29074) (@1ovsss)
  • f399c84f85fc4e3a19ac1e8314ff111493d26fee: fix(controller): use diff cache when timeout.reconciliation is disabled (cherry-pick #29073 for 3.5) (#29158) (@argo-cd-cherry-pick-bot[bot])
  • 960bed7f2efcdc8b43fe392dd6d17cf95507c9f2: fix(server): prevent SSD CLI secret mask spoofing (cherry-pick #29089 for 3.5) (#29130) (@argo-cd-cherry-pick-bot[bot])
  • 9f360f4953a1dc0f3474aa9c482d72366863ea33: fix(ssd): hide secret in last-applied-configuration annotation (#28989) (#29052) (@pjiang-dev)

Other work

  • 109ca7ca71139e514114499d294a492e7910a965: chore: bump version to 3.5.1 on release-3.5 branch (#29165) (@github-actions[bot])
  • b44fbbc2e040e303c18a69182fd5dbe2c36cfdf9: fix(manifest-generate-paths): Consistent gen manifest cache key (#28074 and #29037) (#29049) (@agaudreault)

Full Changelog: https://github.com/argoproj/argo-cd/compare/v3.5.0...v3.5.1

下载链接