发布日期: 2026-01-13
版本号: v3.1.11

本文档为Argo CD v3.1.11版本的发布说明。提供了非高可用和高可用两种快速安装方式，均通过kubectl命令创建命名空间并应用对应的YAML清单完成部署。所有Argo CD容器镜像均使用cosign签名，并为符合SLSA Level 3规范的镜像与CLI生成出处信息，以供验证。若从其他次要版本升级，请务必参考相关升级文档。本次更新包含若干错误修复，例如修复了应用集在允许的命名空间外更新集群密钥时触发不必要的协调、优化资源规范更新提示的显示逻辑、修复了仓库类型下拉菜单选择无效的问题，并更新了相关依赖与测试配置。完整变更日志可查阅官方比较页面。

更新内容 （中文）

快速开始

非高可用部署：

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

高可用部署：

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

发布签名与出处证明

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

发布说明博文

如需了解本次发布的关键变更与改进详情，请查看官方博文

升级指南

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

变更日志

缺陷修复

  • b424210b52626aaad422674e24c286df058cea79: fix(appset): do not trigger reconciliation on appsets not part of allowed namespaces when updating a cluster secret (cherry-pick #25622 for 3.1) (#25910) (@argo-cd-cherry-pick-bot[bot])
  • cc053b2eebed744df8c33b33fbbadcd0adcd044d: fix(ci): bump golang.x/tools to v0.35.0 (#25955) (@nitishfy)
  • 836d47f311dca78845256e73fa52a4aef186882a: fix: Only show please update resource specification message when spec… (cherry-pick #25066 for 3.1) (#25896) (@argo-cd-cherry-pick-bot[bot])
  • 6c3f3eab5d3e0120774b4b65ac4a93d026d0a8ee: fix: Selecting repoType in dropdown doesn’t do anything (#23747) (#25945) (@keithchong)

其他工作

  • 955ea1b1dfd6a2417b9d928923098cf54fb26a44: chore(cherry-pick-3.1): bump expr version from v1.17.5 to v1.17.7 (#25907) (@aali309)
  • f22ccc2192f860c73f0fea00a68d4778de3c59c8: chore(cherry-pick-3.1): bump go to 1.25.5 and bump expr to v1.17.7 (#25890) (@nitishfy)
  • db2004f2e25039b6bd8753fb239a737822ce4ac2: ci: test against k8s 1.34.2 (cherry-pick #25856 for 3.1) (#25861) (@argo-cd-cherry-pick-bot[bot])

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

更新内容 （原始）

Quick Start

Non-HA:

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

HA:

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

  • b424210b52626aaad422674e24c286df058cea79: fix(appset): do not trigger reconciliation on appsets not part of allowed namespaces when updating a cluster secret (cherry-pick #25622 for 3.1) (#25910) (@argo-cd-cherry-pick-bot[bot])
  • cc053b2eebed744df8c33b33fbbadcd0adcd044d: fix(ci): bump golang.x/tools to v0.35.0 (#25955) (@nitishfy)
  • 836d47f311dca78845256e73fa52a4aef186882a: fix: Only show please update resource specification message when spec… (cherry-pick #25066 for 3.1) (#25896) (@argo-cd-cherry-pick-bot[bot])
  • 6c3f3eab5d3e0120774b4b65ac4a93d026d0a8ee: fix: Selecting repoType in dropdown doesn’t do anything (#23747) (#25945) (@keithchong)

Other work

  • 955ea1b1dfd6a2417b9d928923098cf54fb26a44: chore(cherry-pick-3.1): bump expr version from v1.17.5 to v1.17.7 (#25907) (@aali309)
  • f22ccc2192f860c73f0fea00a68d4778de3c59c8: chore(cherry-pick-3.1): bump go to 1.25.5 and bump expr to v1.17.7 (#25890) (@nitishfy)
  • db2004f2e25039b6bd8753fb239a737822ce4ac2: ci: test against k8s 1.34.2 (cherry-pick #25856 for 3.1) (#25861) (@argo-cd-cherry-pick-bot[bot])

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

下载链接