发布日期: 2026-04-16
版本号: v3.1.14

Argo CD v3.1.14 版本发布提示,在该版本中发现了一个潜在的应用协调缺陷,可能导致应用控制器刷新失败,进而引发应用不同步或资源状态显示异常的问题。用户可通过非高可用(non-HA)或高可用(HA)两种方式在 Kubernetes 集群中快速安装此版本。所有此版本的容器镜像均已通过 cosign 签名,并为符合 SLSA Level 3 规范的容器镜像和 CLI 二进制文件生成了来源证明。如果从其他次要版本升级,请务必查阅升级文档。本次发布包含了一些错误修复和依赖更新,例如修复了自动刷新问题并升级了 fast-xml-parser 等组件。详细的变更说明可查看官方发布的完整变更日志。

更新内容 (中文)

快速入门

[!IMPORTANT] 此版本中发现了一个与应用协调相关的潜在错误。应用控制器可能无法刷新应用,导致应用不同步或显示资源不同步。

问题: #27344 – 应用控制器未刷新应用

非高可用部署:

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

高可用部署:

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

发布签名与出处

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

发布说明博文

要了解此版本中关键变更和改进的详细分解,请查看官方博文

升级指南

如果从其他次版本升级,请务必阅读升级文档。

变更日志

错误修复

  • 76cd807b4e2eb3da6acec19d20905126d8d77f70: fix(ci): 运行 yarn install 时使用 –frozen-lockfile (为 3.1 挑选 #27099) (#27356) (@dudinea)
  • b00f837ebf195f4e8bc2687480019ae58ece49cc: fix: 防止来自 informer 重新同步和状态更新的自动刷新 (为 3.1 挑选 #25290) (#27238) (@aali309)

依赖更新

  • 09e2130c29a7f4ef0667dae58159c11a595e5c6c: chore(deps): 将 /ui 中的 fast-xml-parser 从 4.5.3 升级至 4.5.6 (#27341) (@keithchong)

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

更新内容 (原始)

Quick Start

[!IMPORTANT] A potential bug with application reconciliation has been identified in this release. The application controller may fail to refresh applications, causing an application to not sync / show resources as out of sync.

Issue: #27344 – Application controller not refreshing applications

Non-HA:

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

HA:

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

  • 76cd807b4e2eb3da6acec19d20905126d8d77f70: fix(ci): run yarn install with –frozen-lockfile (cherry-pick #27099 for 3.1) (#27356) (@dudinea)
  • b00f837ebf195f4e8bc2687480019ae58ece49cc: fix: prevent automatic refreshes from informer resync and status updates (cherry-pick #25290 for 3.1) (#27238) (@aali309)

Dependency updates

  • 09e2130c29a7f4ef0667dae58159c11a595e5c6c: chore(deps): bump fast-xml-parser from 4.5.3 to 4.5.6 in /ui (#27341) (@keithchong)

Full Changelog: https://github.com/argoproj/argo-cd/compare/v3.1.13...v3.1.14

下载链接