Akka.Cluster.Sharding 1.3.9-beta68

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
This is a prerelease version of Akka.Cluster.Sharding.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Akka.Cluster.Sharding --version 1.3.9-beta68
NuGet\Install-Package Akka.Cluster.Sharding -Version 1.3.9-beta68
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Akka.Cluster.Sharding" Version="1.3.9-beta68" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Akka.Cluster.Sharding --version 1.3.9-beta68
#r "nuget: Akka.Cluster.Sharding, 1.3.9-beta68"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Akka.Cluster.Sharding as a Cake Addin
#addin nuget:?package=Akka.Cluster.Sharding&version=1.3.9-beta68&prerelease

// Install Akka.Cluster.Sharding as a Cake Tool
#tool nuget:?package=Akka.Cluster.Sharding&version=1.3.9-beta68&prerelease

Sharded actors with managed lifecycle for Akka.NET cluster

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp1.0 was computed.  netcoreapp1.1 was computed.  netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard1.6 is compatible.  netstandard2.0 was computed.  netstandard2.1 was computed. 
.NET Framework net45 is compatible.  net451 was computed.  net452 was computed.  net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen30 was computed.  tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (15)

Showing the top 5 NuGet packages that depend on Akka.Cluster.Sharding:

Package Downloads
Petabridge.Cmd.Cluster.Sharding The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Akka.Cluster.Sharding Petabridge.Cmd palettes for shard management and monitoring.

Akka.Cluster.Hosting The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Akka.Cluster and Akka.Cluster.Sharding Microsoft.Extensions.Hosting support.

wyvern.entity

Package Description

Akkling.Cluster.Sharding

F# wrapper library for Akka.NET cluster sharding module.

Akkatecture.Clustering

clustering library for akkatecture to enable distributed scenarios

GitHub repositories (4)

Showing the top 4 popular GitHub repositories that depend on Akka.Cluster.Sharding:

Repository Stars
petabridge/akkadotnet-code-samples
Akka.NET professional reference code samples
ThembisileNGQ/Akkatecture
a cqrs and event sourcing framework for dotnet core using akka.net
Aaronontheweb/InMemoryCQRSReplication
Akka.NET Reference Architecture - CQRS + Sharding + In-Memory Replication
Horusiath/AkkaCQRS
Event sourcing example build on Akka.NET with persistence plugin
Version Downloads Last updated
1.5.18 3,209 3/12/2024
1.5.17.1 3,327 3/2/2024
1.5.17 185 2/29/2024
1.5.16 6,403 1/29/2024
1.5.15 14,849 1/10/2024
1.5.14 16,398 11/3/2023
1.5.13 36,848 9/18/2023
1.5.13-beta1 387 8/25/2023
1.5.12 20,269 8/2/2023
1.5.11 2,328 7/27/2023
1.5.10 4,267 7/25/2023
1.5.9 7,340 7/17/2023
1.5.8 27,918 6/15/2023
1.5.7 16,731 5/17/2023
1.5.6 7,127 5/8/2023
1.5.5 26,742 5/4/2023
1.5.4 10,226 4/25/2023
1.5.3 2,161 4/20/2023
1.5.2 12,082 4/6/2023
1.5.1 7,690 3/15/2023
1.5.0 9,924 3/2/2023
1.5.0-beta6 877 3/1/2023
1.5.0-beta5 492 3/1/2023
1.5.0-beta4 556 2/28/2023
1.5.0-beta3 645 2/27/2023
1.5.0-beta2 509 2/23/2023
1.5.0-beta1 527 2/20/2023
1.5.0-alpha4 838 2/1/2023
1.5.0-alpha3 718 11/15/2022
1.5.0-alpha2 576 10/17/2022
1.5.0-alpha1 601 8/22/2022
1.4.51 1,048 6/28/2023
1.4.50 3,015 3/15/2023
1.4.49 13,196 1/27/2023
1.4.49-beta1 537 1/11/2023
1.4.48 25,044 1/5/2023
1.4.47 8,486 12/9/2022
1.4.46 24,720 11/15/2022
1.4.45 21,898 10/19/2022
1.4.44 1,968 10/17/2022
1.4.43 9,724 9/27/2022
1.4.42 1,647 9/23/2022
1.4.41 91,508 8/31/2022
1.4.40 12,869 7/22/2022
1.4.39 74,154 6/1/2022
1.4.38 42,165 5/6/2022
1.4.37 10,379 4/14/2022
1.4.36 9,000 4/5/2022
1.4.35 20,619 3/18/2022
1.4.34 6,671 3/7/2022
1.4.33 7,267 2/14/2022
1.4.32 12,398 1/18/2022
1.4.31 28,462 12/21/2021
1.4.30 1,019 12/20/2021
1.4.29 1,409 12/13/2021
1.4.28 47,772 11/10/2021
1.4.27 40,518 10/11/2021
1.4.26 3,890 9/28/2021
1.4.25 5,058 9/8/2021
1.4.24 7,932 8/17/2021
1.4.23 2,917 8/10/2021
1.4.22 5,225 8/5/2021
1.4.21 17,441 6/16/2021
1.4.21-beta1 830 6/4/2021
1.4.20 13,808 5/12/2021
1.4.19 12,195 4/28/2021
1.4.18 9,757 3/23/2021
1.4.17 5,423 3/10/2021
1.4.16 28,537 1/22/2021
1.4.15 1,753 1/20/2021
1.4.14 8,851 12/30/2020
1.4.13 2,478 12/16/2020
1.4.12 18,295 11/16/2020
1.4.11 11,766 11/5/2020
1.4.10 17,356 8/20/2020
1.4.9 14,417 7/21/2020
1.4.8 43,700 6/17/2020
1.4.7 4,972 5/27/2020
1.4.6 6,011 5/12/2020
1.4.5 3,679 4/29/2020
1.4.4 7,610 3/31/2020
1.4.3 4,346 3/18/2020
1.4.2 3,524 3/13/2020
1.4.1 8,130 3/11/2020
1.4.1-rc3 941 3/10/2020
1.4.1-rc2 761 3/10/2020
1.4.1-rc1 1,179 2/28/2020
1.4.0-beta4 2,390 1/28/2020
1.4.0-beta3 6,958 10/30/2019
1.4.0-beta2 3,730 9/23/2019
1.4.0-beta1 2,538 7/19/2019
1.4.0-beta 987 10/30/2019
1.3.18-beta 10,593 3/9/2020
1.3.17-beta 6,678 12/20/2019
1.3.16-beta 2,849 11/14/2019
1.3.15-beta 4,525 9/23/2019
1.3.14-beta 6,979 7/30/2019
1.3.13-beta 18,322 4/30/2019
1.3.12-beta 12,592 3/14/2019
1.3.11-beta 10,490 12/18/2018
1.3.10-beta 80,331 11/2/2018
1.3.9-beta68 38,883 8/23/2018
1.3.9-beta67 1,143 8/23/2018
1.3.9-beta 1,084 8/30/2018
1.3.8-beta66 8,684 6/5/2018
1.3.8-beta65 1,282 6/5/2018
1.3.7-beta64 1,867 5/15/2018
1.3.7-beta63 1,344 5/15/2018
1.3.6-beta62 3,301 4/17/2018
1.3.6-beta61 1,249 4/17/2018
1.3.5-beta60 8,653 2/22/2018
1.3.5-beta59 1,296 2/22/2018
1.3.4-beta58 1,519 2/1/2018
1.3.4-beta57 1,327 2/1/2018
1.3.3-beta56 1,454 1/19/2018
1.3.3-beta55 1,339 1/19/2018
1.3.2-beta54 20,176 10/21/2017
1.3.2-beta53 1,267 10/21/2017
1.3.2-beta 2,100 10/24/2017
1.3.1-beta52 1,933 9/5/2017
1.3.1-beta51 1,259 9/5/2017
1.3.0-beta50 1,335 8/18/2017
1.3.0-beta48 1,239 8/17/2017
1.3.0-beta47 1,304 8/17/2017
1.3.0-beta46 1,287 8/11/2017
1.2.3.43-beta 2,861 7/10/2017
1.2.3.41-beta 1,292 7/10/2017
1.2.2.40-beta 1,335 6/28/2017
1.2.2.39-beta 1,248 6/28/2017
1.2.1.38-beta 1,303 6/23/2017
1.2.1.37-beta 1,326 6/23/2017
1.2.0.36-beta 10,767 4/13/2017
1.2.0.35-beta 1,507 4/13/2017
1.2.0.34-beta 1,234 4/12/2017
1.2.0.33-beta 1,830 4/12/2017
1.1.3.32-beta 2,538 1/23/2017
1.1.3.31-beta 1,465 1/23/2017
1.1.2.30-beta 2,942 9/22/2016
1.1.2.29-beta 1,610 9/22/2016
1.1.1.28-beta 1,397 7/16/2016
1.1.1.27-beta 1,354 7/16/2016
1.1.0.26-beta 1,411 7/7/2016
1.0.8.25-beta 3,112 4/26/2016
1.0.8.24-beta 1,387 4/26/2016
1.0.7.18-beta 1,396 4/6/2016

Maintenance Release for Akka.NET 1.3**
Akka.NET v1.3.9 features some major changes to Akka.Cluster.Sharding, additional Akka.Streams stages, and some general bug fixes across the board.
Akka.Cluster.Sharding Improvements**
The [Akka.Cluster.Sharding documentation](http://getakka.net/articles/clustering/cluster-sharding.html#quickstart) already describes some of the major changes in Akka.NET v1.3.9, but we figured it would be worth calling special attention to those changes here.
Props Factory for Entity Actors**
> In some cases, the actor may need to know the `entityId` associated with it. This can be achieved using the `entityPropsFactory` parameter to `ClusterSharding.Start` or `ClusterSharding.StartAsync`. The entity ID will be passed to the factory as a parameter, which can then be used in the creation of the actor.
In addition to the existing APIs we've always had for defining sharded entities via `Props`, Akka.NET v1.3.9 introduces [a new method overload for `Start`](http://getakka.net/api/Akka.Cluster.Sharding.ClusterSharding.html#Akka_Cluster_Sharding_ClusterSharding_Start_System_String_System_Func_System_String_Akka_Actor_Props__Akka_Cluster_Sharding_ClusterShardingSettings_Akka_Cluster_Sharding_ExtractEntityId_Akka_Cluster_Sharding_ExtractShardId_) and [`StartAsync`](http://getakka.net/api/Akka.Cluster.Sharding.ClusterSharding.html#Akka_Cluster_Sharding_ClusterSharding_StartAsync_System_String_System_Func_System_String_Akka_Actor_Props__Akka_Cluster_Sharding_ClusterShardingSettings_Akka_Cluster_Sharding_ExtractEntityId_Akka_Cluster_Sharding_ExtractShardId_) which allows users to pass in the `entityId` of each entity actor as a constructor argument to those entities when they start.
For example:
```
var anotherCounterShard = ClusterSharding.Get(Sys).Start(
                       typeName: "AnotherCounter",
                       entityProps: Props.Create<AnotherCounter>(),
                       typeName: AnotherCounter.ShardingTypeName,
                       entityPropsFactory: entityId => AnotherCounter.Props(entityId),
                       settings: ClusterShardingSettings.Create(Sys),
                       extractEntityId: Counter.ExtractEntityId,
                       extractShardId: Counter.ExtractShardId);
```
This will give you the opportunity to pass in the `entityId` for each actor as a constructor argument into the `Props` of your entity actor and possibly other use cases too.
Improvements to Starting and Querying Existing Shard Entity Types**
Two additional major usability improvements to Cluster.Sharding come from some API additions and changes.
The first is that it's now possible to look up all of the currently registered shard types via the [`ClusterSharding.ShardTypeNames` property](http://getakka.net/api/Akka.Cluster.Sharding.ClusterSharding.html#Akka_Cluster_Sharding_ClusterSharding_ShardTypeNames). So long as a `ShardRegion` of that type has been started in the cluster, that entity type name will be added to the collection exposed by this property.
The other major usability improvement is a change to the `ClusterSharding.Start` property itself. Historically, you used to have to know whether or not the node you wanted to use sharding on was going to be hosting shards (call `ClusterSharding.Start`) or simply communicated with shards hosted on a different cluster role type (call `ClusterSharding.StartProxy`). Going forward, it's safe to call `ClusterSharding.Start` on any node and you will either receive an `IActorRef` to active `ShardRegion` or a `ShardRegion` running in "proxy only" mode; this is determined by looking at the `ClusterShardingSettings` and determining if the current node is in a role that is allowed to host shards of this type.
[Akka.Cluster.Sharding: Sharding API Updates](https://github.com/akkadotnet/akka.net/pull/3524)
[Akka.Cluster.Sharding: sharding rebalance fix](https://github.com/akkadotnet/akka.net/pull/3518)
[Akka.Cluster.Sharding: log formatting fix](https://github.com/akkadotnet/akka.net/pull/3554)
[Akka.Cluster.Sharding: `RestartShard` escapes into userspace](https://github.com/akkadotnet/akka.net/pull/3509)
Akka.Streams Additions and Changes**
In Akka.NET v1.3.9 we've added some new built-in stream stages and API methods designed to help improve developer productivity and ease of use.
[Akka.Streams: add CombineMaterialized method to Source](https://github.com/akkadotnet/akka.net/pull/3489)
[Akka.Streams:
KillSwitches: flow stage from CancellationToken](https://github.com/akkadotnet/akka.net/pull/3568)
[Akka.Streams: Port KeepAliveConcat and UnfoldFlow](https://github.com/akkadotnet/akka.net/pull/3560)
[Akka.Streams: Port PagedSource & IntervalBasedRateLimiter](https://github.com/akkadotnet/akka.net/pull/3570)
Other Updates, Additions, and Bugfixes**
[Akka.Cluster: cluster coordinated leave fix for empty cluster](https://github.com/akkadotnet/akka.net/pull/3516)
[Akka.Cluster.Tools: bumped ClusterClient message drop log messages from DEBUG to WARNING](https://github.com/akkadotnet/akka.net/pull/3513)
[Akka.Cluster.Tools: Singleton - confirm TakeOverFromMe when singleton already in oldest state](https://github.com/akkadotnet/akka.net/pull/3553)
[Akka.Remote: RemoteWatcher race-condition fix](https://github.com/akkadotnet/akka.net/pull/3519)
[Akka: fix concurrency bug in CircuitBreaker](https://github.com/akkadotnet/akka.net/pull/3505)
[Akka: Fixed ReceiveTimeout not triggered in some case when combined with NotInfluenceReceiveTimeout messages](https://github.com/akkadotnet/akka.net/pull/3555)
[Akka.Persistence: Optimized recovery](https://github.com/akkadotnet/akka.net/pull/3549)
[Akka.Persistence: Allow persisting events when recovery has completed](https://github.com/akkadotnet/akka.net/pull/3366)
To [see the full set of changes for Akka.NET v1.3.9, click here](https://github.com/akkadotnet/akka.net/milestone/27).
| COMMITS | LOC+ | LOC- | AUTHOR |
| --- | --- | --- | --- |
| 28 | 2448 | 5691 | Aaron Stannard |
| 11 | 1373 | 230 | zbynek001 |
| 8 | 4590 | 577 | Bartosz Sypytkowski |
| 4 | 438 | 99 | Ismael Hamed |
| 4 | 230 | 240 | Sean Gilliam |
| 2 | 1438 | 0 | Oleksandr Bogomaz |
| 1 | 86 | 79 | Nick Polideropoulos |
| 1 | 78 | 0 | v1rusw0rm |
| 1 | 4 | 4 | Joshua Garnett |
| 1 | 32 | 17 | Jarl Sveinung Flø Rasmussen |
| 1 | 27 | 1 | Sam13 |
| 1 | 250 | 220 | Maxim Cherednik |
| 1 | 184 | 124 | Josh Taylor |
| 1 | 14 | 0 | Peter Shrosbree |
| 1 | 1278 | 42 | Marc Piechura |
| 1 | 1 | 1 | Vasily Kirichenko |
| 1 | 1 | 1 | Samuel Kelemen |
| 1 | 1 | 1 | Nyola Mike |
| 1 | 1 | 1 | Fábio Beirão |