The documentation you are viewing is for Dapr v1.12 which is an older version of Dapr. For up-to-date documentation, see the latest version.

支持的版本

发布支持和升级策略

介绍

本主题详细介绍了 Dapr 发布的受支持的版本、升级策略以及如何传达弃用和重大更改。

Dapr 版本使用 MAJOR.MINOR.PATCH 版本控制。 例如 1.0.0

  • PATCH 版本会递增,以进行错误和安全热修复。
  • MINOR 版本作为常规发布节奏的一部分进行更新,包括新功能,错误和安全修复。
  • MAJOR 版本在运行时发生不向后兼容的更改(如 API 更改)时更新。 MAJOR 版本也可能发生,然后会考虑与先前版本区分开来的重大功能添加/更改。

支持的版本意味着:

  • 如果发布版本存在关键问题(如主线损坏情况或安全问题),则会发布 hoxfix 修补程序。 其中每一项都是根据具体情况进行审查的。
  • 将调查受支持版本的问题。 如果某个版本不再受支持,则需要升级到较新的版本,并确定该问题是否仍然相关。

从1.0.0版本开始,支持两个版本的 Dapr;当前版本和前一个主要版本。 通常,这些是次要发布更新。 这意味着有一个版本滚动窗口,用于更新到受支持的版本,并且您的操作责任是维护升级到最新受支持版本。 如果您使用的是较旧版本的 Dapr,则可能必须执行过渡升级才能获得受支持的版本。

在 major.minor 版本发布之间将至少有 6 周的时间,为用户提供 12 周(3 个月)的滚动升级窗口。

补丁支持仅适用于受支持的版本(当前版本和前一个主要版本)。

支持的版本

下表显示了 Dapr 发布的版本,这些版本已被一起测试并形成一个 “打包 “的版本。 不支持任何其他版本组合。

发布日期 Runtime CLI SDK 仪表板 状态
2021年2月17日 1.0.0
1.0.0 Java 1.0.0
Go 1.0.0
PHP 1.0.0
Python 1.0.0
.NET 1.0.0
0.6.0 不受支持
2021年3月4日 1.0.1
1.0.1 Java 1.0.2
Go 1.0.0
PHP 1.0.0
Python 1.0.0
.NET 1.0.0
0.6.0 不受支持
2021年4月1日 1.1.0
1.1.0 Java 1.0.2
Go 1.1.0
PHP 1.0.0
Python 1.1.0
.NET 1.1.0
0.6.0 不受支持
2021年4月6日 1.1.1
1.1.0 Java 1.0.2
Go 1.1.0
PHP 1.0.0
Python 1.1.0
.NET 1.1.0
0.6.0 不受支持
2021年4月16日 1.1.2
1.1.0 Java 1.0.2
Go 1.1.0
PHP 1.0.0
Python 1.1.0
.NET 1.1.0
0.6.0 不受支持
2021年5月26日 1.2.0
1.2.0 Java 1.1.0
Go 1.1.0
PHP 1.1.0
Python 1.1.0
.NET 1.2.0
0.6.0 不受支持
2021年6月16日 1.2.1
1.2.0 Java 1.1.0
Go 1.1.0
PHP 1.1.0
Python 1.1.0
.NET 1.2.0
0.6.0 不受支持
2021年6月16日 1.2.2
1.2.0 Java 1.1.0
Go 1.1.0
PHP 1.1.0
Python 1.1.0
.NET 1.2.0
0.6.0 不受支持
2021年7月26日 1.3
1.3.0 Java 1.2.0
Go 1.2.0
PHP 1.1.0
Python 1.2.0
.NET 1.3.0
0.7.0 不受支持
2021年9月14日 1.3.1
1.3.0 Java 1.2.0
Go 1.2.0
PHP 1.1.0
Python 1.2.0
.NET 1.3.0
0.7.0 不受支持
2021年9月15日 1.4
1.4.0 Java 1.3.0
Go 1.2.0
PHP 1.1.0
Python 1.3.0
.NET 1.4.0
0.8.0 不受支持
2021年9月22日 1.4.1
1.4.0 Java 1.3.0
Go 1.2.0
PHP 1.1.0
Python 1.3.0
.NET 1.4.0
0.8.0 不受支持
2021年9月24日 1.4.2
1.4.0 Java 1.3.0
Go 1.2.0
PHP 1.1.0
Python 1.3.0
.NET 1.4.0
0.8.0 不受支持
2021年10月7日 1.4.3
1.4.0 Java 1.3.0
Go 1.2.0
PHP 1.1.0
Python 1.3.0
.NET 1.4.0
0.8.0 不受支持
2021年11月6日 1.4.4
1.4.0 Java 1.3.0
Go 1.2.0
PHP 1.1.0
Python 1.3.0
.NET 1.4.0
0.8.0 不受支持
2021年11月11日 1.5.0
1.5.0 Java 1.3.0
Go 1.3.0
PHP 1.1.0
Python 1.4.0
.NET 1.5.0
JS 1.0.2
0.9.0 支持
2021年12月6日 1.5.1
1.5.1 Java 1.3.0
Go 1.3.0
PHP 1.1.0
Python 1.4.0
.NET 1.5.0
JS 1.0.2
0.9.0 支持
2021年12月6日 1.5.1
1.5.1 Java 1.3.0
Go 1.3.0
PHP 1.1.0
Python 1.4.0
.NET 1.5.0
JS 1.0.2
0.9.0 支持
2022年3月25日 1.5.2
1.6.0 Java 1.3.0
Go 1.3.0
PHP 1.1.0
Python 1.4.0
.NET 1.5.0
JS 1.0.2
0.9.0 支持
2022年1月25日 1.6.0
1.6.0 Java 1.4.0
Go 1.3.1
PHP 1.1.0
Python 1.5.0
.NET 1.6.0
JS 2.0.0
0.9.0 支持
2022年3月25日 1.6.1
1.6.0 Java 1.4.0
Go 1.3.1
PHP 1.1.0
Python 1.5.0
.NET 1.6.0
JS 2.0.0
0.9.0 支持(当前)

升级路径

在 1.0 版本之后,可能需要通过之间版本显式升级才能达到所需的目标版本。 例如,从 v1.0 升级到 v1.2 可能需要通过 v1.1

下表显示了 Dapr 运行时的测试升级路径。 任何其他升级组合尚未经过测试。

有关升级的通用指南,请参阅 自托管模式Kubernetes 部署。 最好查看目标版本发行说明以获取特定指导。

当前运行时版本 必须升级通过 目标运行时版本
1.0.0 或 1.0.1 N/A 1.1.2
1.1.2 1.2.2
1.2.2 1.3.1
1.3.1 1.4.4
1.4.4 1.5.2
1.5.2 1.6.0
1.6.0 1.6.1
1.1.0 到 1.1.2 N/A 1.2.2
1.2.2 1.3.1
1.3.1 1.4.4
1.4.4 1.5.2
1.5.2 1.6.0
1.6.0 1.6.1
1.2.0 到 1.2.2 N/A 1.3.1
1.3.1 1.4.4
1.4.4 1.5.1
1.5.2 1.6.0
1.6.0 1.6.1
1.3.0 N/A 1.3.1
1.3.1 1.4.4
1.4.4 1.5.2
1.5.2 1.6.0
1.6.0 1.6.1
1.3.1 N/A 1.4.4
1.4.4 1.5.1
1.5.1 1.6.0
1.6.0 1.6.1
1.4.0 到 1.4.2 N/A 1.4.4
1.4.4 1.5.2
1.5.2 1.6.0
1.6.0 1.6.1
1.5.0 到 1.5.2 N/A 1.6.0
1.6.0 1.6.1
1.6.0 N/A 1.6.1

功能和弃用

Dapr 有一个宣布功能弃用的过程。 弃用会发生在宣布弃用发布的两个版本之后。 例如,功能 X 在 1.0.0 发行说明中被宣布弃用,然后在 1.2.0 中真正被弃用。

弃用出现在发行说明中名为"弃用"的部分下,该部分表示:

  • 将来将不再支持现已弃用的功能。 例如,版本 x.y.z。 至少在两个版本之前宣布过弃用。
  • 在发行说明中记录用户修改其代码、操作等必须采取的任何步骤(如果适用)。

在宣布将来的破坏性改动后,更改将在 2 个版本后或 6 个月内发生,以及大者为准。 已弃用的功能应以警告响应,但不执行其他操作。

已宣布的弃用

特性 废弃通知 移除
GET /v1.0/shutdown API (用户应该使用 POST API 替代) 1.2.0 1.4.0

在托管平台上升级

Dapr 可以支持多个托管平台进行生产。 在 1.0 版本中,两个受支持的平台是 Kubernetes 和物理机。 有关 Kubernetes 升级,请参阅有关 Kubernetes 生产指南

支持的依赖项版本

下面是最新版本的 Dapr(v1.12.4)已经测试过的软件列表。

依赖 支持的版本
Kubernetes Dapr 对 Kubernetes 的支持与 Kubernetes 版本偏差策略一致
Open Telemetry collector (OTEL) v0.4.0
Prometheus v2.28

相关链接