发布日期: 2026-03-09
版本号: v3.3.3

Argo CD v3.3.3版本发布，主要更新了Kubernetes集群版本的解释方式以与Helm 3.19.0保持一致。使用集群生成器并依赖auto-label-cluster-info注解的Application Sets需要更新为使用kubernetes-version注解，并采用完整的vMajor.Minor.Patch版本格式。可通过提供的非高可用或高可用命令快速安装。所有容器镜像均经过签名验证。升级前请务必查阅官方升级文档。此次更新包含了多项错误修复，如修复CNPG操作注解、处理钩子注解、UI图标显示以及与Helm版本的一致性等问题。完整的变更日志可访问其GitHub对比页面。

更新内容 （中文）

[!IMPORTANT] 遵循 Helm 3.19.0 对 Helm 如何解释 K8s 集群版本的更改，Argo CD 3.3.3 版本包含一个更改，使 Argo CD 解释 K8s 集群版本的方式与 Helm 行为对齐。

影响：使用集群生成器的 Application Sets，这些生成器基于 Kubernetes 版本获取集群并在集群密钥上使用 argocd.argoproj.io/auto-label-cluster-info，需要更新为使用 argocd.argoproj.io/kubernetes-version 与 vMajor.Minor.Patch 格式，而不是之前的 Major.Minor 格式。

更多详情请见：https://argo-cd.readthedocs.io/en/stable/operator-manual/upgrading/3.2-3.3/#cluster-version-format-change

快速开始

非高可用：

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

高可用：

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

发布签名和来源证明

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

发布说明博客文章

有关此版本关键更改和改进的详细分解，请查看官方博客文章

升级

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

变更日志

错误修复

  • 6224d6787e11f06b2b259de8548787e59acfd839: fix(actions): 为 CNPG 暂停/恢复使用正确的注解（cherry-pick #26711 for 3.3）（#26727）（@argo-cd-cherry-pick-bot[bot]）
  • 968c6338a706911a7d63e08986de60ac15b81514: fix(controller): 处理 PreDelete/PostDelete 钩子的逗号分隔注解（cherry-pick #26420 for 3.3）（#26586）（@argo-cd-cherry-pick-bot[bot]）
  • 4411801980b1594907b9c9bb524188be519fe405: fix(health): 当可用时使用 note.drySha（cherry-pick #26698 for 3.3）（#26750）（@argo-cd-cherry-pick-bot[bot]）
  • 3d3760f4b4cc63c4a347c4824e97f7416954a378: fix(ui): 标准资源图标未正确显示。#26216（cherry-pick #26228 for 3.3）（#26380）（@argo-cd-cherry-pick-bot[bot]）
  • c6df35db8eca91ba87e371fbd2a13a97b0db4bab: fix: 使 kubeversion 与 helm 版本 3 保持一致（#26744）（@ppapapetrou76）
  • 5e190219c9cb885fae6d2ae0ecfe1961fea8b70b: fix: 为集群作用域的多层级跨命名空间层次结构遍历…（#26640）（@agaudreault）

其他工作

  • c61c5931ce6584abb3dbb02f1c512fcbb2873c6a: chore: 使用 base ref 进行 cherry-pick PR（cherry-pick #26551 for 3.3）（#26553）（@argo-cd-cherry-pick-bot[bot]）

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

更新内容 （原始）

[!IMPORTANT] Following Helm 3.19.0 change in how Helm interprets K8s cluster version, Argo CD 3.3.3 release contains a change that aligns how Argo CD interprets K8s cluster version with Helm behavior.

Impact: Application Sets with Cluster Generators, that fetch clusters based on their Kubernetes version and use argocd.argoproj.io/auto-label-cluster-info on the cluster secret, need to be updated to use argocd.argoproj.io/kubernetes-version with the vMajor.Minor.Patch format instead of the previous Major.Minor format.

More details here: https://argo-cd.readthedocs.io/en/stable/operator-manual/upgrading/3.2-3.3/#cluster-version-format-change

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.3.3/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.3.3/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

  • 6224d6787e11f06b2b259de8548787e59acfd839: fix(actions): Use correct annotation for CNPG suspend/resume (cherry-pick #26711 for 3.3) (#26727) (@argo-cd-cherry-pick-bot[bot])
  • 968c6338a706911a7d63e08986de60ac15b81514: fix(controller): handle comma-separated hook annotations for PreDelete/PostDelete hooks (cherry-pick #26420 for 3.3) (#26586) (@argo-cd-cherry-pick-bot[bot])
  • 4411801980b1594907b9c9bb524188be519fe405: fix(health): use note.drySha when available (cherry-pick #26698 for 3.3) (#26750) (@argo-cd-cherry-pick-bot[bot])
  • 3d3760f4b4cc63c4a347c4824e97f7416954a378: fix(ui): standard resource icons are not displayed properly.#26216 (cherry-pick #26228 for 3.3) (#26380) (@argo-cd-cherry-pick-bot[bot])
  • c6df35db8eca91ba87e371fbd2a13a97b0db4bab: fix: consistency of kubeversion with helm version 3 3 (#26744) (@ppapapetrou76)
  • 5e190219c9cb885fae6d2ae0ecfe1961fea8b70b: fix: multi-level cross-namespace hierarchy traversal for cluster-scop… (#26640) (@agaudreault)

Other work

  • c61c5931ce6584abb3dbb02f1c512fcbb2873c6a: chore: use base ref for cherry-pick prs (cherry-pick #26551 for 3.3) (#26553) (@argo-cd-cherry-pick-bot[bot])

Full Changelog: https://github.com/argoproj/argo-cd/compare/v3.3.2...v3.3.3

下载链接