发布日期: 2025-12-24
版本号: v3.1.10

Argo CD v3.1.10版本提供了快速的安装指引，包括标准部署和高可用部署两种方式，均通过kubectl命令应用官方清单文件即可完成。该版本所有容器镜像均经过cosign签名并生成符合SLSA Level 3规范的来源证明，提供了详细的验证文档。更新说明中，重点介绍了从其他版本升级时需查阅升级指南。变更记录包含多项错误修复，主要涉及应用集注解保留、UI界面状态处理、特定资源健康状态判断及错误信息捕获等方面；同时更新了相关文档，改进了对注解跟踪等用法的说明，并升级了部分依赖库。完整变更日志可通过比较版本号查阅。

更新内容 （中文）

快速开始

非高可用模式：

kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.1.10/manifests/install.yaml

高可用模式：

kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.1.10/manifests/ha/install.yaml

发布签名与出处证明

所有 Argo CD 容器镜像均由 cosign 签名。符合 SLSA Level 3 规范的容器镜像和 CLI 二进制文件会生成出处证明。请参阅文档了解验证方法。

发布说明博文

关于本次发布的主要变更和改进详情，请查看官方博文

升级指南

若从其他次要版本升级，请务必阅读升级文档。

变更日志

缺陷修复

  • 38c15ada45c9b8bd98cd2daa6d308c2f0d24b803: fix(hydrator): 当请求水合操作时应用集应保留注解 (cherry-pick #25644 for 3.1) (#25653) (@argo-cd-cherry-pick-bot[bot])
  • 787f3ec6a2582542761d1e2e4d31433688c0e34e: fix(ui): 为状态面板中的 assignedWindows 添加空值安全处理 (cherry-pick #25128 for 3.1) (#25181) (@argo-cd-cherry-pick-bot[bot])
  • f9ada0403d555c2b5df45c87a3866327d40d0267: fix: 当停止条件为 False 时允许 ISVC 处于健康状态 (cherry-pick #25312 for 3.1) (#25317) (@argo-cd-cherry-pick-bot[bot])
  • 7eca62c2d606f1fce95445d8403dd0ca95f9360c: fix: 为具有多代版本的 HTTPRoute 修复健康状态问题 (#24958) (cherry-pick #24959 for 3.1) (#25037) (@lindeskar)
  • 49ee0040c40f6434c756b4bea4bdfabe7ce58ef9: fix: 在 executil RunWithExecRunOpts 中捕获标准错误 (cherry-pick #25139 for 3.1) (#25141) (@argo-cd-cherry-pick-bot[bot])
  • b6660a2a7ae738d131c4bc37019e2db84ebc8dc9: fix:(ui) 仅在面板显示时渲染 ApplicationSelector (Cherry pick release 3.1) (#25218) (@jwinters01)

文档

  • 11e7758ca921a7b23ccd14680a492f6a5b7e9f65: docs: 记录 ?. 在通知触发器中的用法并修复示例 (#25352) (cherry-pick #25418 for 3.1) (#25422) (@argo-cd-cherry-pick-bot[bot])
  • f2f4f4579b79d231ff3bcb318fa7023bd19e02f6: docs: 改进注解跟踪切换文档，说明可能需要新的 Git 提交以避免产生孤立资源 (cherry-pick #25309 for 3.1) (#25337) (@reggie-k)

依赖更新

  • f4f21b3642a79850627b410ebd961d751cd791f3: chore(deps): 将 golang.org/x/crypto 从 0.39.0 升级至 0.46.0 (#25792) (@anandf)

完整变更日志: https://github.com/argoproj/argo-cd/compare/v3.1.9...v3.1.10

更新内容 （原始）

Quick Start

Non-HA:

kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.1.10/manifests/install.yaml

HA:

kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.1.10/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

  • 38c15ada45c9b8bd98cd2daa6d308c2f0d24b803: fix(hydrator): appset should preserve annotation when hydration is requested (cherry-pick #25644 for 3.1) (#25653) (@argo-cd-cherry-pick-bot[bot])
  • 787f3ec6a2582542761d1e2e4d31433688c0e34e: fix(ui): add null-safe handling for assignedWindows in status panel (cherry-pick #25128 for 3.1) (#25181) (@argo-cd-cherry-pick-bot[bot])
  • f9ada0403d555c2b5df45c87a3866327d40d0267: fix: Allow the ISVC to be healthy when the Stopped Condition is False (cherry-pick #25312 for 3.1) (#25317) (@argo-cd-cherry-pick-bot[bot])
  • 7eca62c2d606f1fce95445d8403dd0ca95f9360c: fix: Health status for HTTPRoute with multiple generations (#24958) (cherry-pick #24959 for 3.1) (#25037) (@lindeskar)
  • 49ee0040c40f6434c756b4bea4bdfabe7ce58ef9: fix: capture stderr in executil RunWithExecRunOpts (cherry-pick #25139 for 3.1) (#25141) (@argo-cd-cherry-pick-bot[bot])
  • b6660a2a7ae738d131c4bc37019e2db84ebc8dc9: fix:(ui) don’t render ApplicationSelector unless the panel is showing (Cherry pick release 3.1) (#25218) (@jwinters01)

Documentation

  • 11e7758ca921a7b23ccd14680a492f6a5b7e9f65: docs: Document usage of ?. in notifications triggers and fix examples (#25352) (cherry-pick #25418 for 3.1) (#25422) (@argo-cd-cherry-pick-bot[bot])
  • f2f4f4579b79d231ff3bcb318fa7023bd19e02f6: docs: Improve switch to annotation tracking docs, clarifying that a new Git commit may be needed to avoid orphan resources - (cherry-pick #25309 for 3.1) (#25337) (@reggie-k)

Dependency updates

  • f4f21b3642a79850627b410ebd961d751cd791f3: chore(deps): bump golang.org/x/crypto from 0.39.0 to 0.46.0 (#25792) (@anandf)

Full Changelog: https://github.com/argoproj/argo-cd/compare/v3.1.9...v3.1.10

下载链接