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

Argo CD v3.3.7 版本发布。本版本存在一个已知问题：应用控制器可能无法刷新应用，导致应用不同步或资源显示不同步状态（问题编号 #27344）。安装提供了两种方式：标准非高可用模式和高可用（HA）模式，均通过 kubectl 在 argocd 命名空间下应用官方清单文件完成。所有容器镜像和 CLI 二进制文件均由 cosign 签名，并附带符合 SLSA Level 3 规范的来源证明。从其他次版本升级时，请务必参考升级文档。本次更新包含多项错误修复，主要涉及性能优化、安全头部增强、UI问题修复、OCI元数据渲染、错误处理改进以及防止不必要的应用刷新等。同时，也更新了部分依赖库。完整变更日志可查看比较 v3.3.6 与 v3.3.7 的差异。

更新内容 （中文）

快速开始

[!IMPORTANT] 本版本中已发现一个关于应用协调的潜在缺陷。应用控制器可能无法刷新应用，导致应用无法同步或显示资源不同步。

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

非高可用（Non-HA）部署：

kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.3.7/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.7/manifests/ha/install.yaml

发布签名与来源

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

发布说明博客文章

欲了解本版本关键变更与改进的详细分解，请查看官方博客文章

升级指南

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

变更日志

缺陷修复

  • ea51bd8047e5ec171ea753bcce4008064b7b6393: [release-3.3] 修复：性能优化：将parentUIDToChildren改为集合映射，移除缓存重建 (#26863) (#27108) (@jcogilvie)
  • 4d2f2613d8f12fb38064c6f05a9f4ea6ba892a01: 修复(持续集成)：使用 –frozen-lockfile 运行 yarn install（#27099 的 3.3 分支移植） (#27351) (@dudinea)
  • 671efff31dc8a2c2726f0066ea7b02e7e64efa71: 修复(控制器)：减少 secret 深拷贝与反序列化操作 (#27049)（release-3.3 分支移植） (#27129) (@rumstead)
  • a77c1501fe213602bfcb7a7d8da2657c783026e6: 修复(文档)：修正 Source Hydrator 文档中的清单路径（#27123 的 3.3 分支移植） (#27167) (@argo-cd-cherry-pick-bot[bot])
  • f0b924f0b01633b538e054b09ef6efb062faa10b: 修复(服务端)：确保服务器重启时刷新 OIDC 配置（#26913 的 3.3 分支移植） (#27114) (@argo-cd-cherry-pick-bot[bot])
  • 7eedc7ac4e36ef9bc52a32f100fc65a861c3bb75: 修复(用户界面)：由于冲突的保护子句导致 OCI 修订版元数据从未渲染 (#26948)（#27097 的 3.3 分支移植） (#27365) (@argo-cd-cherry-pick-bot[bot])
  • b0e04154cf1fcc5bb6f892082665bb1c1135dd48: 修复(用户界面)：处理流中的 401 错误（#26917 的 3.3 分支移植） (#27227) (@argo-cd-cherry-pick-bot[bot])
  • 3b12b2e0d537308703bd84bbc0a65ac9051936e2: 修复：为 Swagger UI 端点添加 X-Frame-Options 和 CSP 头（#26521 的 3.3 分支移植） (#27154) (@argo-cd-cherry-pick-bot[bot])
  • 4939e1fb84beb75286e0a1eb2394f32e3c39e610: 修复：使用自定义 TLS 配置时强制尝试 HTTP/2（#26976 的 3.3 分支移植） (#27358) (@SamyDjemai)
  • e372a7f09c8e5892f6cea13ab73ef1b4aa40d730: 修复：将 repo.insecure 标志传递给 helm dependency build（#27078 的 3.3 分支移植） (#27083) (@argo-cd-cherry-pick-bot[bot])
  • 99e88e0963b8975cde7fc6c1cda302cbdac5f6d7: 修复：防止来自 informer 重新同步和状态更新的自动刷新（#25290 的 3.3 分支移植） (#27230) (@argo-cd-cherry-pick-bot[bot])
  • 2512512b0cd9fc15aff334c60c89cd14d7e5f87c: 修复：在应用集规约变更时触发应用同步（#26811 的 3.3 分支移植） (#27130) (@argo-cd-cherry-pick-bot[bot])
  • e451591448ac3897d54fdeed39338b1d78f01e07: 修复：在 copyutil 符号链接中使用强制标志以防止 repo-server 崩溃（#26613 的 3.3 分支移植） (#27057) (@argo-cd-cherry-pick-bot[bot])
  • b948ff074dc61fb0ccd80cab0caf1e66b59e59c3: 修复：为初始提交使用唯一名称（#27171 的 3.3 分支移植） (#27197) (@argo-cd-cherry-pick-bot[bot])

依赖项更新

  • 899c5e819c7f95f5907a449c8dea878c85265ac7: 维护(依赖项)：在 /ui 中将 fast-xml-parser 从 4.5.3 升级到 4.5.6 - 3.3 (#27360) (@keithchong)
  • 7fd134a040307259745a0d56ac3844a5087a362f: 维护(依赖项)：将 go-jose 从 4.1.3 升级到 4.1.4（#27101 的…分支移植） (#27208) (@blakepettersson)
  • 2daefc045249285ea449095f32f676d4233a24a2: 维护(依赖项)：在 release-3.3 分支中将 notifications-engine 依赖项更新到 v0.5.1-0.20260316232552-d27ba0152c1c (#27093) (@pasha-codefresh)

其他工作

  • 45cbc8421ca30a9777592fcf92bf9ac0f8dd40a1: 测试(端到端)：为启用渐进式同步时的反向 deletionOrder 添加端到端测试（#26673 的 3.3 分支移植） (#27340) (@ranakan19)

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

更新内容 （原始）

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 --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/v3.3.7/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.7/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

  • ea51bd8047e5ec171ea753bcce4008064b7b6393: [release-3.3] fix: improve perf: switch parentUIDToChildren to map of sets, remove cache rebuild (#26863) (#27108) (@jcogilvie)
  • 4d2f2613d8f12fb38064c6f05a9f4ea6ba892a01: fix(ci): run yarn install with –frozen-lockfile (cherry-pick #27099 for 3.3) (#27351) (@dudinea)
  • 671efff31dc8a2c2726f0066ea7b02e7e64efa71: fix(controller): reduce secret deepcopies and deserialization (#27049) (cherry-pick release-3.3) (#27129) (@rumstead)
  • a77c1501fe213602bfcb7a7d8da2657c783026e6: fix(docs): Fix manifest path in Source Hydrator docs (cherry-pick #27123 for 3.3) (#27167) (@argo-cd-cherry-pick-bot[bot])
  • f0b924f0b01633b538e054b09ef6efb062faa10b: fix(server): Ensure OIDC config is refreshed at server restart (cherry-pick #26913 for 3.3) (#27114) (@argo-cd-cherry-pick-bot[bot])
  • 7eedc7ac4e36ef9bc52a32f100fc65a861c3bb75: fix(ui): OCI revision metadata never renders due to conflicting guard clause (#26948) (cherry-pick #27097 for 3.3) (#27365) (@argo-cd-cherry-pick-bot[bot])
  • b0e04154cf1fcc5bb6f892082665bb1c1135dd48: fix(ui): handle 401 error in stream (cherry-pick #26917 for 3.3) (#27227) (@argo-cd-cherry-pick-bot[bot])
  • 3b12b2e0d537308703bd84bbc0a65ac9051936e2: fix: Add X-Frame-Options and CSP headers to Swagger UI endpoints (cherry-pick #26521 for 3.3) (#27154) (@argo-cd-cherry-pick-bot[bot])
  • 4939e1fb84beb75286e0a1eb2394f32e3c39e610: fix: force attempt http2 with custom tls config (cherry-pick #26976 for 3.3) (#27358) (@SamyDjemai)
  • e372a7f09c8e5892f6cea13ab73ef1b4aa40d730: fix: pass repo.insecure flag to helm dependency build (cherry-pick #27078 for 3.3) (#27083) (@argo-cd-cherry-pick-bot[bot])
  • 99e88e0963b8975cde7fc6c1cda302cbdac5f6d7: fix: prevent automatic refreshes from informer resync and status updates (cherry-pick #25290 for 3.3) (#27230) (@argo-cd-cherry-pick-bot[bot])
  • 2512512b0cd9fc15aff334c60c89cd14d7e5f87c: fix: trigger app sync on app-set spec change (cherry-pick #26811 for 3.3) (#27130) (@argo-cd-cherry-pick-bot[bot])
  • e451591448ac3897d54fdeed39338b1d78f01e07: fix: use force flag in copyutil symlink to prevent repo-server crashes (cherry-pick #26613 for 3.3) (#27057) (@argo-cd-cherry-pick-bot[bot])
  • b948ff074dc61fb0ccd80cab0caf1e66b59e59c3: fix: use unique names for initial commits (cherry-pick #27171 for 3.3) (#27197) (@argo-cd-cherry-pick-bot[bot])

Dependency updates

  • 899c5e819c7f95f5907a449c8dea878c85265ac7: chore(deps): bump fast-xml-parser from 4.5.3 to 4.5.6 in /ui - 3.3 (#27360) (@keithchong)
  • 7fd134a040307259745a0d56ac3844a5087a362f: chore(deps): bump go-jose from 4.1.3 to 4.1.4 (cherry-pick #27101 for… (#27208) (@blakepettersson)
  • 2daefc045249285ea449095f32f676d4233a24a2: chore(deps): update notifications-engine dependency in release-3.3 to v0.5.1-0.20260316232552-d27ba0152c1c (#27093) (@pasha-codefresh)

Other work

  • 45cbc8421ca30a9777592fcf92bf9ac0f8dd40a1: test(e2e): add e2e tests for reverse deletionOrder when progressive sync enabled (cherry-pick #26673 for 3.3) (#27340) (@ranakan19)

Full Changelog: https://github.com/argoproj/argo-cd/compare/v3.3.6...v3.3.7

下载链接