Akka.Cluster 1.0.0-pre1504092226

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.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Akka.Cluster --version 1.0.0-pre1504092226
NuGet\Install-Package Akka.Cluster -Version 1.0.0-pre1504092226
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" Version="1.0.0-pre1504092226" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Akka.Cluster --version 1.0.0-pre1504092226
#r "nuget: Akka.Cluster, 1.0.0-pre1504092226"
#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 as a Cake Addin
#addin nuget:?package=Akka.Cluster&version=1.0.0-pre1504092226&prerelease

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

Cluster support for Akka.NET

Product Compatible and additional computed target framework versions.
.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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (34)

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

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

Distributed publish/subscribe, client and singleton support for Akka.NET cluster

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

Replicated data using CRDT structures

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

Akka.Cluster Petabridge.Cmd palettes for cluster management and monitoring.

wyvern.entity

Package Description

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

Akka.NET and Akka.Cluster healthchecks for environments like K8s, AWS, Azure, Pivotal Cloud Foundry, and more.

GitHub repositories (1)

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

Repository Stars
ThembisileNGQ/Akkatecture
a cqrs and event sourcing framework for dotnet core using akka.net
Version Downloads Last updated
1.5.18 969 3/12/2024
1.5.17.1 3,422 3/2/2024
1.5.17 411 2/29/2024
1.5.16 9,710 1/29/2024
1.5.15 16,168 1/10/2024
1.5.14 22,758 11/3/2023
1.5.13 49,083 9/18/2023
1.5.13-beta1 733 8/25/2023
1.5.12 40,559 8/2/2023
1.5.11 3,102 7/27/2023
1.5.10 5,785 7/25/2023
1.5.9 13,189 7/17/2023
1.5.8 47,970 6/15/2023
1.5.7 46,084 5/17/2023
1.5.6 9,315 5/8/2023
1.5.5 28,268 5/4/2023
1.5.4 12,349 4/25/2023
1.5.3 2,964 4/20/2023
1.5.2 43,645 4/6/2023
1.5.1 10,133 3/15/2023
1.5.0 36,838 3/2/2023
1.5.0-beta6 1,318 3/1/2023
1.5.0-beta5 883 3/1/2023
1.5.0-beta4 927 2/28/2023
1.5.0-beta3 988 2/27/2023
1.5.0-beta2 949 2/23/2023
1.5.0-beta1 2,465 2/20/2023
1.5.0-alpha4 1,227 2/1/2023
1.5.0-alpha3 1,424 11/15/2022
1.5.0-alpha2 962 10/17/2022
1.5.0-alpha1 1,043 8/22/2022
1.4.51 3,263 6/28/2023
1.4.50 10,778 3/15/2023
1.4.49 24,330 1/27/2023
1.4.49-beta1 842 1/11/2023
1.4.48 30,790 1/5/2023
1.4.47 17,967 12/9/2022
1.4.46 32,841 11/15/2022
1.4.45 28,344 10/19/2022
1.4.44 3,815 10/17/2022
1.4.43 14,168 9/27/2022
1.4.42 4,535 9/23/2022
1.4.41 99,051 8/31/2022
1.4.40 18,159 7/22/2022
1.4.39 91,287 6/1/2022
1.4.38 42,030 5/6/2022
1.4.37 28,477 4/14/2022
1.4.36 16,988 4/5/2022
1.4.35 25,529 3/18/2022
1.4.34 13,937 3/7/2022
1.4.33 38,973 2/14/2022
1.4.32 21,996 1/18/2022
1.4.31 35,615 12/21/2021
1.4.30 2,172 12/20/2021
1.4.29 4,093 12/13/2021
1.4.28 73,911 11/10/2021
1.4.27 65,655 10/11/2021
1.4.26 7,201 9/28/2021
1.4.25 12,448 9/8/2021
1.4.24 15,366 8/17/2021
1.4.23 5,158 8/10/2021
1.4.22 7,041 8/5/2021
1.4.21 48,185 6/16/2021
1.4.21-beta1 1,525 6/4/2021
1.4.20 28,312 5/12/2021
1.4.19 64,237 4/28/2021
1.4.18 17,810 3/23/2021
1.4.17 10,336 3/10/2021
1.4.16 45,997 1/22/2021
1.4.15 4,114 1/20/2021
1.4.14 16,377 12/30/2020
1.4.13 5,222 12/16/2020
1.4.12 217,852 11/16/2020
1.4.11 21,844 11/5/2020
1.4.10 63,708 8/20/2020
1.4.9 37,157 7/21/2020
1.4.8 61,297 6/17/2020
1.4.7 11,985 5/27/2020
1.4.6 14,394 5/12/2020
1.4.5 8,663 4/29/2020
1.4.4 19,017 3/31/2020
1.4.3 12,803 3/18/2020
1.4.2 6,628 3/13/2020
1.4.1 26,115 3/11/2020
1.4.1-rc3 2,290 3/10/2020
1.4.1-rc2 1,702 3/10/2020
1.4.1-rc1 2,463 2/28/2020
1.4.0-beta4 2,882 1/28/2020
1.4.0-beta3 9,478 10/30/2019
1.4.0-beta2 4,384 9/23/2019
1.4.0-beta1 3,759 7/19/2019
1.3.18 18,874 3/9/2020
1.3.17 67,513 12/20/2019
1.3.16 26,270 11/14/2019
1.3.15 69,294 9/23/2019
1.3.14 56,526 7/30/2019
1.3.13 47,359 4/30/2019
1.3.12 99,676 3/14/2019
1.3.11 113,002 12/18/2018
1.3.10 97,127 11/2/2018
1.3.9 49,687 8/23/2018
1.3.8 40,349 6/5/2018
1.3.7 7,980 5/15/2018
1.3.6 8,006 4/17/2018
1.3.5 22,769 2/22/2018
1.3.4 8,464 2/1/2018
1.3.3 8,588 1/19/2018
1.3.2 34,810 10/21/2017
1.3.1 12,533 9/5/2017
1.3.0 7,811 8/11/2017
1.2.3 13,216 7/10/2017
1.2.2 3,851 6/28/2017
1.2.1 3,834 6/23/2017
1.2.0 28,775 4/12/2017
1.1.3 12,376 1/23/2017
1.1.2 16,193 9/22/2016
1.1.1 8,319 7/16/2016
1.1.0 8,204 7/7/2016
1.0.8.25-beta 3,644 4/26/2016
1.0.8.24-beta 1,858 4/26/2016
1.0.7.18-beta 2,638 4/6/2016
1.0.6.17-beta 4,863 1/18/2016
1.0.6.16-beta 941 1/18/2016
1.0.5.15-beta 1,982 12/3/2015
1.0.5.14-beta 1,105 12/3/2015
1.0.4.12-beta 3,749 8/7/2015
1.0.3.11-beta 1,277 6/12/2015
1.0.2.9-beta 1,664 6/3/2015
1.0.1-pre1504282013 1,679 4/28/2015
1.0.0-pre1504092226 1,282 4/9/2015
1.0.0-dev1504032244 1,068 4/3/2015
0.8.0-pre1502120115 1,288 2/12/2015
0.7.1-pre1412132130 1,397 12/13/2014
0.7.0-pre1410202041 1,179 10/20/2014
0.7.0-pre1410201924 1,341 10/20/2014

Akka.NET is officially no longer in beta status**. The APIs introduced in Akka.NET v1.0 will enjoy long-term support from the Akka.NET development team and all of its professional support partners.
Many breaking changes were introduced between v0.8 and v1.0 in order to provide better future extensibility and flexibility for Akka.NET, and we will outline the major changes in detail in these release notes.
However, if you want full API documentation we recommend going to the following:
[Latest Stable Akka.NET API Docs](http://api.getakka.net/docs/stable/index.html "Akka.NET Latest Stable API Docs")**
[Akka.NET Wiki](http://getakka.net/wiki/ "Akka.NET Wiki")**
----
Updated Packages with 1.0 Stable Release**
All of the following NuGet packages have been upgraded to 1.0 for stable release:
- Akka.NET Core
- Akka.FSharp
- Akka.Remote
- Akka.TestKit
- Akka.DI (dependency injection)
- Akka.Loggers (logging)
The following packages (and modules dependent on them) are still in *pre-release* status:
- Akka.Cluster
- Akka.Persistence
----
Introducing Full Mono Support for Akka.NET**
One of the biggest changes in Akka.NET v1.0 is the introduction of full Mono support across all modules; we even have [Raspberry PI machines talking to laptops over Akka.Remote](https://twitter.com/AkkaDotNET/status/584109606714093568)!
We've tested everything using Mono v3.12.1 across OS X and Ubuntu.
[Please let us know how well Akka.NET + Mono runs on your environment](https://github.com/akkadotnet/akka.net/issues/694)!**
----
API Changes in v1.0**
All methods returning an `ActorRef` now return `IActorRef`**
This is the most significant breaking change introduced in AKka.NET v1.0. Rather than returning the `ActorRef` abstract base class from all of the `ActorOf`, `Sender` and other methods we now return an instance of the `IActorRef` interface instead.
This was done in order to guarantee greater future extensibility without additional breaking changes, so we decided to pay off that technical debt now that we're supporting these APIs long-term.
Here's the set of breaking changes you need to be aware of:
- Renamed:
- `ActorRef`          --> `IActorRef`
- `ActorRef.Nobody`   --> `ActorRefs.Nobody`
- `ActorRef.NoSender` --> `ActorRefs.NoSender`
- `ActorRef`'s  operators `==` and `!=` has been removed. This means all expressions like `actorRef1 == actorRef2` must be replaced with `Equals(actorRef1, actorRef2)`
- `Tell(object message)`, i.e. the implicit sender overload, has been moved
to an extension method, and requires `using Akka.Actor;` to be accessible.
- Implicit cast from `ActorRef` to `Routee` has been replaced with `Routee.FromActorRef(actorRef)`
`async` / `await` Support**
`ReceiveActor`s now support Async/Await out of the box.
```csharp
public class MyActor : ReceiveActor
{
public MyActor()
{
Receive<SomeMessage>(async some => {
//we can now safely use await inside this receive handler
await SomeAsyncIO(some.Data);
Sender.Tell(new EverythingIsAllOK());
});
}
}
```
It is also possible to specify the behavior for the async handler, using `AsyncBehavior.Suspend` and  `AsyncBehavior.Reentrant` as the first argument.
When using `Suspend` the normal actor semantics will be preserved, the actor will not be able to process any new messages until the current async operation is completed.
While using `Reentrant` will allow the actor to multiplex messages during the `await` period.
This does not mean that messages are processed in parallel, we still stay true to "one message at a time", but each await continuation will be piped back to the actor as a message and continue under the actors concurrency constraint.
However, `PipeTo` pattern is still the preferred way to perform async operations inside an actor, as it is more explicit and clearly states what is going on.
Switchable Behaviors**
In order to make the switchable behavior APIs more understandable for both `UntypedActor` and `ReceiveActor` we've updated the methods to the following:
``` C#
Become(newHandler); // become newHandler, without adding previous behavior to the stack (default)
BecomeStacked(newHandler); // become newHandler, without adding previous behavior to the stack (default)
UnbecomeStacked(); //revert to the previous behavior in the stack
```
The underlying behavior-switching implementation hasn't changed at all - only the names of the methods.
Scheduler APIs**
The `Context.System.Scheduler` API has been overhauled to be both more extensible and understandable going forward. All of the previous capabilities for the `Scheduler` are still available, only in different packaging than they were before.
Here are the new APIs:
``` C#
Context.System.Scheduler
.ScheduleTellOnce(TimeSpan delay, ICanTell receiver, object message, ActorRef sender);
.ScheduleTellOnce(TimeSpan delay, ICanTell receiver, object message, ActorRef sender, ICancelable cancelable);
.ScheduleTellRepeatedly(TimeSpan initialDelay, TimeSpan interval, ICanTell receiver, object message, ActorRef sender);
.ScheduleTellRepeatedly(TimeSpan initialDelay, TimeSpan interval, ICanTell receiver, object message, ActorRef sender, ICancelable cancelable);
Context.System.Scheduler.Advanced
.ScheduleOnce(TimeSpan delay, Action action);
.ScheduleOnce(TimeSpan delay, Action action, ICancelable cancelable);
.ScheduleRepeatedly(TimeSpan initialDelay, TimeSpan interval, Action action);
.ScheduleRepeatedly(TimeSpan initialDelay, TimeSpan interval, Action action, ICancelable cancelable);
```
There's also a set of extension methods for specifying delays and intervals in milliseconds as well as methods for all four variants (`ScheduleTellOnceCancelable`, `ScheduleTellRepeatedlyCancelable`, `ScheduleOnceCancelable`, `ScheduleRepeatedlyCancelable`) that creates a cancelable, schedules, and returns the cancelable.
Akka.NET `Config` now loaded automatically from App.config and Web.config**
In previous versions Akka.NET users had to do the following to load Akka.NET HOCON configuration sections from App.config or Web.config:
```csharp
var section = (AkkaConfigurationSection)ConfigurationManager.GetSection("akka");
var config = section.AkkaConfig;
var actorSystem = ActorSystem.Create("MySystem", config);
```
As of Akka.NET v1.0 this is now done for you automatically:
```csharp
var actorSystem = ActorSystem.Create("MySystem"); //automatically loads App/Web.config, if any
```
Dispatchers**
Akka.NET v1.0 introduces the `ForkJoinDispatcher` as well as general purpose dispatcher re-use.
Using ForkJoinDispatcher**
ForkJoinDispatcher is special - it uses [`Helios.Concurrency.DedicatedThreadPool`](https://github.com/helios-io/DedicatedThreadPool) to create a dedicated set of threads for the exclusive use of the actors configured to use a particular `ForkJoinDispatcher` instance. All of the remoting actors depend on the `default-remote-dispatcher` for instance.
Here's how you can create your own ForkJoinDispatcher instances via Config:
```
myapp{
my-forkjoin-dispatcher{
type = ForkJoinDispatcher
throughput = 100
dedicated-thread-pool{ #settings for Helios.DedicatedThreadPool
thread-count = 3 #number of threads
#deadlock-timeout = 3s #optional timeout for deadlock detection
threadtype = background #values can be "background" or "foreground"
}
}
}
}
```
You can then use this specific `ForkJoinDispatcher` instance by configuring specific actors to use it, whether it's via config or the fluent interface on `Props`:
Config**
```
akka.actor.deploy{
/myActor1{
dispatcher = myapp.my-forkjoin-dispatcher
}
}
```
Props**
```csharp
var actor = Sys.ActorOf(Props.Create<Foo>().WithDispatcher("myapp.my-forkjoin-dispatcher"));
```
FluentConfiguration [REMOVED]**
`FluentConfig` has been removed as we've decided to standardize on HOCON configuration, but if you still want to use the old FluentConfig bits you can find them here: https://github.com/rogeralsing/Akka.FluentConfig
F# API**
The F# API has changed to reflect the other C# interface changes, as well as unique additions specific to F#.
In addition to updating the F# API, we've also fixed a long-standing bug with being able to serialize discriminated unions over the wire. This has been resolved.
Interface Renames**
In order to comply with .NET naming conventions and standards, all of the following interfaces have been renamed with the `I{InterfaceName}` prefix.
The following interfaces have all been renamed to include the `I` prefix:
- [X] `Akka.Actor.ActorRefProvider, Akka` (Public)
- [X] `Akka.Actor.ActorRefScope, Akka` (Public)
- [X] `Akka.Actor.AutoReceivedMessage, Akka` (Public)
- [X] `Akka.Actor.Cell, Akka` (Public)
- [X] `Akka.Actor.Inboxable, Akka` (Public)
- [X] `Akka.Actor.IndirectActorProducer, Akka` (Public)
- [X] `Akka.Actor.Internal.ChildrenContainer, Akka` (Public)
- [X] `Akka.Actor.Internal.ChildStats, Akka` (Public)
- [X] `Akka.Actor.Internal.InternalSupportsTestFSMRef`2, Akka` (Public)
- [X] `Akka.Actor.Internal.SuspendReason+WaitingForChildren, Akka`
- [X] `Akka.Actor.Internals.InitializableActor, Akka` (Public)
- [X] `Akka.Actor.LocalRef, Akka`
- [X] `Akka.Actor.LoggingFSM, Akka` (Public)
- [X] `Akka.Actor.NoSerializationVerificationNeeded, Akka` (Public)
- [X] `Akka.Actor.PossiblyHarmful, Akka` (Public)
- [X] `Akka.Actor.RepointableRef, Akka` (Public)
- [X] `Akka.Actor.WithBoundedStash, Akka` (Public)
- [X] `Akka.Actor.WithUnboundedStash, Akka` (Public)
- [X] `Akka.Dispatch.BlockingMessageQueueSemantics, Akka` (Public)
- [X] `Akka.Dispatch.BoundedDequeBasedMessageQueueSemantics, Akka` (Public)
- [X] `Akka.Dispatch.BoundedMessageQueueSemantics, Akka` (Public)
- [X] `Akka.Dispatch.DequeBasedMailbox, Akka` (Public)
- [X] `Akka.Dispatch.DequeBasedMessageQueueSemantics, Akka` (Public)
- [X] `Akka.Dispatch.MessageQueues.MessageQueue, Akka` (Public)
- [X] `Akka.Dispatch.MultipleConsumerSemantics, Akka` (Public)
- [X] `Akka.Dispatch.RequiresMessageQueue`1, Akka` (Public)
- [X] `Akka.Dispatch.Semantics, Akka` (Public)
- [X] `Akka.Dispatch.SysMsg.SystemMessage, Akka` (Public)
- [X] `Akka.Dispatch.UnboundedDequeBasedMessageQueueSemantics, Akka` (Public)
- [X] `Akka.Dispatch.UnboundedMessageQueueSemantics, Akka` (Public)
- [X] `Akka.Event.LoggingAdapter, Akka` (Public)
- [X] `Akka.FluentConfigInternals, Akka` (Public)
- [X] `Akka.Remote.InboundMessageDispatcher, Akka.Remote`
- [X] `Akka.Remote.RemoteRef, Akka.Remote`
- [X] `Akka.Routing.ConsistentHashable, Akka` (Public)
`ConsistentHashRouter` and `IConsistentHashable`**
Akka.NET v1.0 introduces the idea of virtual nodes to the `ConsistentHashRouter`, which are designed to provide more even distributions of hash ranges across a relatively small number of routees. You can take advantage of virtual nodes via configuration:
```xml
akka.actor.deployment {
/router1 {
router = consistent-hashing-pool
nr-of-instances = 3
virtual-nodes-factor = 17
}
}
```
Or via code:
```csharp
var router4 = Sys.ActorOf(Props.Empty.WithRouter(
new ConsistentHashingGroup(new[]{c},hashMapping: hashMapping)
.WithVirtualNodesFactor(5)),
"router4");
```
`ConsistentHashMapping` Delegate**
There are three ways to instruct a router to hash a message:
1. Wrap the message in a `ConsistentHashableEnvelope`;
2. Implement the `IConsistentHashable` interface on your message types; or
3. Or, write a `ConsistentHashMapper` delegate and pass it to a `ConsistentHashingGroup` or a `ConsistentHashingPool` programmatically at create time.
Here's an example, taken from the `ConsistentHashSpecs`:
```csharp
ConsistentHashMapping hashMapping = msg =>
{
if (msg is Msg2)
{
var m2 = msg as Msg2;
return m2.Key;
}
return null;
};
var router2 =
Sys.ActorOf(new ConsistentHashingPool(1, null, null, null, hashMapping: hashMapping)
.Props(Props.Create<Echo>()), "router2");
```
Alternatively, you don't have to pass the `ConsistentHashMapping` into the constructor - you can use the `WithHashMapping` fluent interface built on top of both `ConsistentHashingGroup` and `ConsistentHashingPool`:
```csharp
var router2 =
Sys.ActorOf(new ConsistentHashingPool(1).WithHashMapping(hashMapping)
.Props(Props.Create<Echo>()), "router2");
```
`ConsistentHashable` renamed to `IConsistentHashable`**
Any objects you may have decorated with the `ConsistentHashable` interface to work with `ConsistentHashRouter` instances will need to implement `IConsistentHashable` going forward, as all interfaces have been renamed with the `I-` prefix per .NET naming conventions.
Akka.DI.Unity NuGet Package**
Akka.NET now ships with dependency injection support for [Unity](https://unity.codeplex.com/).
You can install our Unity package via the following command in the NuGet package manager console:
```
PM> Install-Package Akka.DI.Unity
```
----