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

Supported releases

Release support and upgrade policies

介绍

This topic details the supported versions of Dapr releases, the upgrade policies and how deprecations and breaking changes are communicated.

Dapr releases use MAJOR.MINOR.PATCH versioning. For example 1.0.0

  • A PATCH version is incremented for bug and security hot fixes.
  • A MINOR version is updated as part of the regular release cadence, including new features, bug and security fixes.
  • A MAJOR version is updated when there’s a non-backward compatible change to the runtime, such as an API change. A MAJOR release can also occur then there is a considered a significant addition/change of functionality that needs to differentiate from the previous version.

A supported release means;

  • A hoxfix patch is released if the release has a critical issue such as a mainline broken scenario or a security issue. Each of these are reviewed on a case by case basis.
  • Issues are investigated for the supported releases. If a release is no longer supported, you need to upgrade to a newer release and determine if the issue is still relevant.

From the 1.0.0 release onwards two (2) versions of Dapr are supported; the current and previous versions. Typically these are MINORrelease updates. This means that there is a rolling window that moves forward for supported releases and it is your operational responsibility to remain up to date with these supported versions. If you have an older version of Dapr you may have to do intermediate upgrades to get to a supported version.

There will be at least 6 weeks between major.minor version releases giving users a 12 week (3 month) rolling window for upgrading.

Patch support is for supported versions (current and previous).

Supported versions

The table below shows the versions of Dapr releases that have been tested together and form a “packaged” release. Any other combinations of releases are not supported.

发布日期 Runtime CLI SDK Dashboard 状态
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 不受支持
Jun 16th 2021 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 不受支持
Jun 16th 2021 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 不受支持
Jul 26th 2021 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 支持
Sep 14th 2021 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 支持
Sep 15th 2021 1.4
 1.4.0 Java 1.3.0
Go 1.3.0
PHP 1.2.0
Python 1.3.0
.NET 1.4.0		 0.8.0 支持
Sep 22nd 2021 1.4.1
 1.4.0 Java 1.3.0
Go 1.3.0
PHP 1.2.0
Python 1.3.0
.NET 1.4.0		 0.8.0 支持
Sep 24th 2021 1.4.2
 1.4.0 Java 1.3.0
Go 1.3.0
PHP 1.2.0
Python 1.3.0
.NET 1.4.0		 0.8.0 支持
Oct 7th 2021 1.4.3
 1.4.0 Java 1.3.0
Go 1.3.0
PHP 1.2.0
Python 1.3.0
.NET 1.4.0		 0.8.0 支持
December 6th 2021 1.4.4
 1.4.0 Java 1.3.0
Go 1.3.0
PHP 1.2.0
Python 1.3.0
.NET 1.4.0		 0.8.0 支持（当前）

Upgrade paths

After the 1.0 release of the runtime there may be situations where it is necessary to explicitly upgrade through an additional release to reach the desired target. For example an upgrade from v1.0 to v1.2 may need go pass through v1.1

The table below shows the tested upgrade paths for the Dapr runtime. Any other combinations of upgrades have not been tested.

General guidance on upgrading can be found for self hosted mode and Kubernetes deployments. It is best to review the target version release notes for specific guidance.

Current Runtime version Must upgrade through Target Runtime version
1.0.0 or 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.1.0 to 1.1.2 N/A 1.2.2
1.2.2 1.3.1
1.3.1 1.4.4
1.2.0 to 1.2.2 N/A 1.3.1
1.3.1 1.4.4
1.3.0 N/A 1.3.1
1.3.1 1.4.4
1.3.1 N/A 1.4.4
1.4.0 to 1.4.3 N/A 1.4.4

Feature and deprecations

There is a process for announcing feature deprecations. Deprecations are applied two (2) releases after the release in which they were announced. For example Feature X is announced to be deprecated in the 1.0.0 release notes and will then be removed in 1.2.0.

Deprecations appear in release notes under a section named “Deprecations”, which indicates:

  • The point in the future the now-deprecated feature will no longer be supported. For example release x.y.z. This is at least two (2) releases prior.
  • Document any steps the user must take to modify their code, operations, etc if applicable in the release notes.

After announcing a future breaking change, the change will happen in 2 releases or 6 months, whichever is greater. Deprecated features should respond with warning but do nothing otherwise.

Announced deprecations

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

Upgrade on Hosting platforms

Dapr can support multiple hosting platforms for production. With the 1.0 release the two supported platforms are Kubernetes and physical machines. For Kubernetes upgrades see Production guidelines on Kubernetes

Supported Kubernetes versions

Dapr follows Kubernetes Version Skew Policy.

相关链接