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

Argo CD v3.0.21 版本发布了主要更新，包括修复了多个错误（如注解处理、UI面板显示和存储库缓存问题）、完善了文档并更新了依赖项。安装时可根据需求选择标准模式或高可用（HA）模式，通过对应的命令将清单文件应用到 Kubernetes 的 argocd 命名空间中。从早期版本升级时请务必参考升级文档。所有容器镜像均通过 cosign 签名，并生成符合 SLSA Level 3 标准的出处证明，验证方法详见相关文档。完整的变更日志和升级指南可通过官方渠道获取。

更新内容 （中文）

快速开始

非高可用版本：

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

高可用版本：

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

发布签名与来源证明

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

发布说明博文

如需了解本版本关键变更与改进的详细解析，请查阅官方博文

升级指南

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

变更日志

问题修复

  • 8910d47425d352a37604c4d461abb5afbd0b877b: fix(hydrator): appset应在请求时保留注释信息 (cherry-pick #25644 for 3.0) (#25652) (@argo-cd-cherry-pick-bot[bot])
  • ad1eacbe93c2e6163ff989702dcddfbe8cd8ab95: fix(ui): 为状态面板中的assignedWindows添加空值安全处理 (cherry-pick #25128 for 3.0) (#25182) (@argo-cd-cherry-pick-bot[bot])
  • a9a7868dc4e18cda89c8ccea7746a2eea7621859: fix: 当停止条件为False时允许ISVC处于健康状态 (cherry-pick #25312 for 3.0) (#25316) (@argo-cd-cherry-pick-bot[bot])
  • b53d2a244325ca48a3dc520b4c7453afcc43f413: fix: 在repo服务器缓存中正确处理带注释的git标签 (cherry-pick #21771 for 3.0) (#25241) (@argo-cd-cherry-pick-bot[bot])
  • ba78f8cdeb3e980db201d7ec93985d4aab3bcc9b: fix:(ui) 仅当面板显示时才渲染ApplicationSelector (Cherry Pick release-3.0) (#25217) (@jwinters01)

文档更新

  • a24b8ec7d24eaf947f5a0b550dd27741d61bd2e5: docs: 记录通知触发器中?.的使用方法并修复示例 (#25352) (cherry-pick #25418 for 3.0) (#25423) (@argo-cd-cherry-pick-bot[bot])
  • 97dc75ee80b64c1bec11249cbda3d8aa0e5cd957: docs: 完善切换到注释跟踪的文档，明确指出可能需要新Git提交以避免孤立资源 - (cherry-pick #25309 for 3.0) (#25336) (@reggie-k)

依赖更新

  • 38b108e2553c5ec962899040ee8ec2eb1ccd7123: chore(deps): 升级gitops-engine至包含#24242修复的版本 (#25548) (@anandf)
  • 73b21ff4f2fa7f134ffe0c03cc0d9332eb1ef556: chore(deps): 将golang.org/x/crypto从0.38.0升级至0.46.0 (#25821) (@anandf)

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

更新内容 （原始）

Quick Start

Non-HA:

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

HA:

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

  • 8910d47425d352a37604c4d461abb5afbd0b877b: fix(hydrator): appset should preserve annotation when hydration is requested (cherry-pick #25644 for 3.0) (#25652) (@argo-cd-cherry-pick-bot[bot])
  • ad1eacbe93c2e6163ff989702dcddfbe8cd8ab95: fix(ui): add null-safe handling for assignedWindows in status panel (cherry-pick #25128 for 3.0) (#25182) (@argo-cd-cherry-pick-bot[bot])
  • a9a7868dc4e18cda89c8ccea7746a2eea7621859: fix: Allow the ISVC to be healthy when the Stopped Condition is False (cherry-pick #25312 for 3.0) (#25316) (@argo-cd-cherry-pick-bot[bot])
  • b53d2a244325ca48a3dc520b4c7453afcc43f413: fix: handle annotated git tags correctly in repo server cache (cherry-pick #21771 for 3.0) (#25241) (@argo-cd-cherry-pick-bot[bot])
  • ba78f8cdeb3e980db201d7ec93985d4aab3bcc9b: fix:(ui) don’t render ApplicationSelector unless the panel is showing (Cherry Pick release-3.0) (#25217) (@jwinters01)

Documentation

  • a24b8ec7d24eaf947f5a0b550dd27741d61bd2e5: docs: Document usage of ?. in notifications triggers and fix examples (#25352) (cherry-pick #25418 for 3.0) (#25423) (@argo-cd-cherry-pick-bot[bot])
  • 97dc75ee80b64c1bec11249cbda3d8aa0e5cd957: 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.0) (#25336) (@reggie-k)

Dependency updates

  • 38b108e2553c5ec962899040ee8ec2eb1ccd7123: chore(deps): bump gitops-engine to include fix for #24242 (#25548) (@anandf)
  • 73b21ff4f2fa7f134ffe0c03cc0d9332eb1ef556: chore(deps): bump golang.org/x/crypto from 0.38.0 to 0.46.0 (#25821) (@anandf)

Full Changelog: https://github.com/argoproj/argo-cd/compare/v3.0.20...v3.0.21

下载链接