发布日期: 2025-07-09
版本号: v3.1.0-rc2

Argo CD v3.1.0-rc2版本现已发布，提供了快速部署指南：非高可用模式下，在argocd命名空间中应用标准安装清单；高可用模式下，则应用ha安装清单。所有Argo CD容器镜像均由cosign签名，并为符合SLSA三级规范的容器镜像和CLI二进制文件生成了出处证明，详情请参考相关文档以进行验证。关于本版本关键变更和改进的详细说明，请查阅官方博客文章。若从不同次版本升级，请务必阅读升级文档。此版本主要包含功能更新，如将Helm升级至3.18.3、Kustomize升级至5.7.0；以及多项错误修复，涉及控制器、水合器、服务器、同步、OCI客户端和用户界面等问题。完整的变更日志可在GitHub比较页面查看。

更新内容 （中文）

快速入门

非高可用模式：

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

高可用模式：

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

发布签名与来源证明

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

发布说明博文

关于本次发布关键变更与改进的详细解析，请查阅官方博文

升级指南

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

更新日志

功能特性

  • 7224a15502d4a9589f1c10f28cca8c9e0d998386: feat(helm): 升级至 3.18.3 (cherry-pick #23618) (#23620) (@gcp-cherry-pick-bot[bot])
  • 563d45b8dbdd339a973cb6bede9449b3a21bc825: feat(kustomize): 升级至 5.7.0 (#23619) (#23625) (@crenshaw-dev)

问题修复

  • 75f7016d89f8fbc0084402d23dec57e03c8e4106: fix(controller): 从环境变量获取提交服务器URL (cherry-pick #23536) (#23541) (@gcp-cherry-pick-bot[bot])
  • 37f2793e95aab6b488f3ad134661f90b623a4451: fix(hydrator): 从 hydrator.metadata 中省略 Argocd- 跟踪信息 (cherry-pick #23463) (#23621) (@gcp-cherry-pick-bot[bot])
  • 1cbd28cb3022e19b46d8d8522f221a353b87ea6f: fix(server): 使参数化资源操作保持向后兼容 (cherry-pick #23695) (#23709) (@gcp-cherry-pick-bot[bot])
  • 6142c5bf565be12b7b9e857912c503e5e77729f1: fix(sync): FailOnSharedResource 场景下的自动同步循环问题 (#23357) (#23640) (@agaudreault)
  • c215dbf202aaabcad6f3d2b486cd600ceee91108: fix: OCI客户端，当版本非约束条件时避免调用标签列表 #23580 (cherry-pick #23581) (#23582) (@gcp-cherry-pick-bot[bot])
  • dd675feb3317c90eb05017811136a396bfc1a683: fix: 任意命名空间中 ApplicationSet 的界面错误 (cherry-pick #23601) (#23604) (@gcp-cherry-pick-bot[bot])
  • 6fe5ec794af6cb170461a7801452185e808da648: fix: 改进因控制器同步超时终止操作时的界面消息 (cherry-pick #23657) (#23672) (@gcp-cherry-pick-bot[bot])
  • 4a7e581080ad0945b859c11b3610242d166f9a54: fix: kustomize 组件与代码仓库集成问题 (cherry-pick #23486) (#23540) (@gcp-cherry-pick-bot[bot])

文档更新

  • fed347da294dcd6df9479c9ba85d0880e6e9373c: docs(images): 添加关于 3.0 版本镜像缺失的说明 (#23612) (cherry-pick #23712) (#23713) (@gcp-cherry-pick-bot[bot])

完整更新日志: https://github.com/argoproj/argo-cd/compare/v3.1.0-rc1...v3.1.0-rc2

更新内容 （原始）

Quick Start

Non-HA:

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

HA:

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

Features

  • 7224a15502d4a9589f1c10f28cca8c9e0d998386: feat(helm): upgrade to 3.18.3 (cherry-pick #23618) (#23620) (@gcp-cherry-pick-bot[bot])
  • 563d45b8dbdd339a973cb6bede9449b3a21bc825: feat(kustomize): upgrade to 5.7.0 (#23619) (#23625) (@crenshaw-dev)

Bug fixes

  • 75f7016d89f8fbc0084402d23dec57e03c8e4106: fix(controller): get commit server url from env (cherry-pick #23536) (#23541) (@gcp-cherry-pick-bot[bot])
  • 37f2793e95aab6b488f3ad134661f90b623a4451: fix(hydrator): omit Argocd- trailers from hydrator.metadata (cherry-pick #23463) (#23621) (@gcp-cherry-pick-bot[bot])
  • 1cbd28cb3022e19b46d8d8522f221a353b87ea6f: fix(server): make parameterized resource actions backwards-compatible (cherry-pick #23695) (#23709) (@gcp-cherry-pick-bot[bot])
  • 6142c5bf565be12b7b9e857912c503e5e77729f1: fix(sync): auto-sync loop when FailOnSharedResource (#23357) (#23640) (@agaudreault)
  • c215dbf202aaabcad6f3d2b486cd600ceee91108: fix: OCI client, avoid calling tags/list if revision is not a constraint #23580 (cherry-pick #23581) (#23582) (@gcp-cherry-pick-bot[bot])
  • dd675feb3317c90eb05017811136a396bfc1a683: fix: UI error with ApplicationSet in any namespace (cherry-pick #23601) (#23604) (@gcp-cherry-pick-bot[bot])
  • 6fe5ec794af6cb170461a7801452185e808da648: fix: improves the ui message when an operation is terminated due to controller sync timeout (cherry-pick #23657) (#23672) (@gcp-cherry-pick-bot[bot])
  • 4a7e581080ad0945b859c11b3610242d166f9a54: fix: kustomize components + monorepos (cherry-pick #23486) (#23540) (@gcp-cherry-pick-bot[bot])

Documentation

  • fed347da294dcd6df9479c9ba85d0880e6e9373c: docs(images): add a note about missing images for 3.0 releases (#23612) (cherry-pick #23712) (#23713) (@gcp-cherry-pick-bot[bot])

Full Changelog: https://github.com/argoproj/argo-cd/compare/v3.1.0-rc1...v3.1.0-rc2

下载链接