docs/release_notes/v1.5.0.md
We're happy to announce the release of Dapr 1.5.0!
We would like to extend our thanks to all the new and existing contributors who helped make this release happen.
StableThe Dapr Steering and Technical Committee (STC) voted to change the components certification criteria and rename components from GA to Stable.
The following components are now upgraded to Stable indicating that they are suitable for use in production scenarios:
In addition, multiple fixes have been made to other components including RabbitMQ pub/sub, MySQL state store, and PostgreSQL state store.
For more information see the Dapr components reference.
The state management building block API now includes a query API, currently in Alpha state. This API provides a way of querying the key/value data stored in state store components. It is not a replacement for a complete query language, and is focused on retrieving, filtering and sorting key/value data that you have saved through the state store APIs.
Even though the state store is a key/value store, the value might be a JSON document with its own hierarchy, keys, and values. This query API allows you to use those keys and values to retrieve corresponding documents.
For more information read the state management query API docs.
Configuration is a new building block API introduced in this release and is currently in Alpha state. Consuming application configuration is a common task when writing applications and frequently configuration stores are used to manage this configuration data. A configuration item is often dynamic in nature and is tightly coupled to the needs of the application that consumes it. The Configuration API provides an abstraction over different stores and exposes key/value data and importantly with the ability to subscribe to configuration item update notfications.
In this initial release this API can only be used over gRPC. HTTP will be made available before the final stable release (for example, \v1.0\configuration\myconfigstore).
For more information read the configuration overview.
Virtual actors are now available in the Dapr Go SDK. See go-sdk/21 for details.
For a Dapr actor example using the Go SDK, see go-sdk/examples/actor.
Enhancements to the actor runtime were released to improve reliability. See dapr/1914 and dapr/3533 for details.
Dapr CLI, sidecar and Dashboard are now natively compiled for ARM64 Macs. Also, Dapr CLI installation via Homebrew was fixed. See the Dapr CLI installation instructions for details.
New components added to this release include:
If you're new to Dapr, visit the getting started page and familiarize yourself with Dapr.
Docs have been updated with all the new features and changes of this release. To get started with new capabilities introduced in this release, go to the Concepts and the Developing applications.
See this section on upgrading Dapr to version 1.5.0.
Thanks to everyone who made this release possible!
@1046102779, @AaronCrawfis, @abhishek-galoda, @alvinhenrick, @amimimor, @anhldbk, @AnyISalIn, @apuzyrevsky, @artursouza, @beiwei30, @berndverst, @caogj, @CodeMonkeyLeet, @CrazyHZM, @cshi0, @cwdsuzhou, @daixiang0, @DarinShapiroMS, @Darquewarrior, @denis111, @dmitsh, @doddgu, @fjvela, @greenie-msft, @halspang, @hokandil, @huiyangz, @ItalyPaleAle, @jjcollinge, @Juneezee, @krutsko, @l0ll098, @LaurenceLiZhixin, @li1234yun, @marviniter, @mnussbaum, @msfussell, @mthmulders, @mukundansundar, @orizohar, @penghuima, @pkedy, @qmhu, @ravi-k4, @richgo, @swuecho, @Taction, @tanvigour, @theonefx, @tomkerkhove, @wcs1only, @willtsai, @wmeints, @workfigure, @XavierGeerinck, @yaron2
dapr.io/sidecar-image 3745dapr init 806DaprClient.invoke_binding 274To upgrade to this release of Dapr, follow the steps here to ensure a smooth upgrade. You know, the one where you don't get red errors on the terminal.. we all hate that, right?
Uninstall Dapr using the CLI you currently have installed. Note that this will remove the default $HOME/.dapr directory, binaries and all containers dapr_redis, dapr_placement and dapr_zipkin. Linux users need to run sudo if docker command needs sudo:
dapr uninstall --all
For RC releases like this, download the latest and greatest release from here and put the dapr binary in your PATH.
Once you have installed the CLI, run:
dapr init --runtime-version=1.5.0
Wait for the update to finish, ensure you are using the latest version of Dapr(1.5.0) with:
$ dapr --version
CLI version: 1.5.0
Runtime version: 1.5.0
You can perform zero-downtime upgrades using both Helm 3 and the Dapr CLI.
Download the latest RC release from here and put the dapr binary in your PATH.
To upgrade Dapr, run:
dapr upgrade --runtime-version 1.5.0 -k
To upgrade with high availability mode:
dapr upgrade --runtime-version 1.5.0 --enable-ha=true -k
Wait until the operation is finished and check your status with dapr status -k.
All done!
Note: Make sure your deployments are restarted to pick the latest version of the Dapr sidecar
To upgrade Dapr using Helm, run:
helm repo add dapr https://dapr.github.io/helm-charts/
helm repo update
helm upgrade dapr dapr/dapr --version 1.5.0 --namespace=dapr-system --wait
Wait until the operation is finished and check your status with dapr status -k.
All done!
Note: Make sure your deployments are restarted to pick the latest version of the Dapr sidecar
See how to deploy Dapr on a Kubernetes cluster for a complete guide to installing Dapr on Kubernetes
You can use Helm 3 to install Dapr:
helm repo add dapr https://dapr.github.io/helm-charts/
helm repo update
kubectl create namespace dapr-system
helm install dapr dapr/dapr --version 1.5.0 --namespace dapr-system --wait
Alternatively, you can use the latest version of CLI:
dapr init --runtime-version=1.5.0 -k
Verify the control plane pods are running and are healthy:
$ dapr status -k
NAME NAMESPACE HEALTHY STATUS REPLICAS VERSION AGE CREATED
dapr-dashboard dapr-system True Running 1 0.9.0 15s 2021-11-09 13:07.39
dapr-sidecar-injector dapr-system True Running 1 1.5.0 15s 2021-11-09 13:07.39
dapr-sentry dapr-system True Running 1 1.5.0 15s 2021-11-09 13:07.39
dapr-operator dapr-system True Running 1 1.5.0 15s 2021-11-09 13:07.39
dapr-placement dapr-system True Running 1 1.5.0 15s 2021-11-09 13:07.39
After Dapr 1.5.0 has been installed, perform a rolling restart for your deployments to pick up the new version of the sidecar. This can be done with:
kubectl rollout restart deploy/<deployment-name>
None.