Releases · akkadotnet/akka.net

07 Jul 01:00

Aaronontheweb

v1.1

ba160de

Akka.NET v1.1.0 Stable Release

1.1.0 July 05 2016

Feature Release for Akka.NET

In Akka.NET 1.1 we introduce the following major changes:

Akka.Cluster is no longer in beta; it is released as a fully stable module with a frozen API that is ready for production use.
Akka.Remote now has a new Helios 2.1 transport that is up to 5x faster than the previous implementation and with tremendously lower memory consumption.
The actor mailbox system has been replaced with the MailboxType system, which standardizes all mailbox implementations on a common core and instead allows for pluggable IMessageQueue implementations. This will make it easier to develop user-defined mailboxes and also has the added benefit of reducing all actor memory footprints by 34%.
The entire router system has been updated, including support for new "controller" actors that can be used to adjust a router's routing table in accordance to external events (i.e. a router that adjusts whom it routes to based on CPU utilization, which will be implemented in Akka.Cluster.Metrics).

Full list of Akka.NET 1.1 fixes and changes

API Changes
There have been a couple of important API changes which will affect end-users upgrading from Akka.NET versions 1.0.*.

First breaking change deals with the PriorityMailbox base class, used by developers who need to prioritize specific message types ahead of others.

All user-defined instances of this type must now include the following constructor in order to work (using an example from Akka.NET itself:)

public class IntPriorityMailbox : UnboundedPriorityMailbox
{
    protected override int PriorityGenerator(object message)
    {
        return message as int? ?? Int32.MaxValue;
    }

    public IntPriorityMailbox(Settings settings, Config config) : base(settings, config)
    {
    }
}

There must be a MyMailboxType(Settings settings, Config config) constructor on all custom mailbox types going forward, or a ConfigurationException will be thrown when trying to instantiate an actor who uses the mailbox type.

Second breaking change deals with Akka.Cluster itself. In the past you could access all manner of data from the ClusterReadView class (accessed via the Cluster.ReadView property) - such as the addresses of all other members, who the current leader was, and so forth.

Going forward ClusterReadView is now marked as internal, but if you need access to any of this data you can access the Cluster.State property, which will return a CurrentClusterState object. This contains most of the same information that was previously available on ClusterReadView.

Akka.Streams
Another major part of Akka.NET 1.1 is the introduction of Akka.Streams, a powerful library with a Domain-Specific Language (DSL) that allows you to compose Akka.NET actors and workflows into streams of events and messages.

As of 1.1 Akka.Streams is now available as a beta module on NuGet.

We highly recommend that you read the Akka.Streams Quick Start Guide for Akka.NET as a place to get started.

Akka.Persistence.Query
A second beta module is also now available as part of Akka.NET 1.1, Akka.Persistence.Query - this module is built on top of Akka.Streams and Akka.Persistence and allows users to query ranges of information directly from their underlying Akka.Persistence stores for more powerful types of reads, aggregations, and more.

Akka.Persistence.Query is available for all SQL implementations of Akka.Persistence and will be added to our other Akka.Persistence plugins shortly thereafter.

Thank you!
Thanks for all of your patience and support as we worked to deliver this to you - it's been a tremendous amount of work but we really appreciate the help of all of the bug reports, Gitter questions, StackOverflow questions, and testing that our users have done on Akka.NET and specifically, Akka.Cluster over the past two years. We couldn't have done this without you.

23 contributors since release v1.0.8

COMMITS	LOC+	LOC-	AUTHOR
133	38124	7835	Silv3rcircl3
112	25826	10493	Chris Constantin
70	45449	11556	Bartosz Sypytkowski
44	22804	13971	Alex Valuyskiy
40	9811	6396	Aaron Stannard
12	9539	6619	Marc Piechura
6	1692	959	Sean Gilliam
4	448	0	alexpantyukhin
3	772	4	maxim.salamatko
3	3	382	Danthar
2	40	46	Vagif Abilov
1	91	103	rogeralsing
1	3	3	Jeff Cyr
1	219	44	Michael Kantarovsky
1	2	1	Juergen Hoetzel
1	19	8	tstojecki
1	187	2	Bart de Boer
1	178	0	Willem Meints
1	17	1	Kamil Wojciechowski
1	120	7	JeffCyr
1	11	7	corneliutusnea
1	1	1	Tamas Vajk
1	0	64	annymsMthd

Assets 2

07 Jul 00:59

Aaronontheweb

v1.0.8

be8486a

Akka.NET v1.0.8 Stable Release

1.0.8 April 26 2016

Maintenance release for Akka.NET v1.0.7

Fixes an issue with the 1.0.7 release where the default settings for Akka.Persistence changed and caused potential breaking changes for Akka.Persistence users. Those changes have been reverted back to the same values as previous versions.

General fixes:

Commit Stats for v1.0.8

COMMITS	LOC+	LOC-	AUTHOR
4	240	59	Aaron Stannard
3	268	1	Danthar
3	189	2810	Silv3rcircl3
2	204	4	Willem Meints
2	161	108	Bartosz Sypytkowski
2	101	24	Sean Gilliam
1	25	16	zbynek001

Assets 2

06 Apr 22:53

Aaronontheweb

v1.0.7

820e8c1

Akka.NET v1.0.7 Stable Release

1.0.7 April 4 2016

Maintenance release for Akka.NET v1.0.6
The biggest changes in Akka.NET 1.0.7 have been made to Akka.Persistence, which is now designed to match the final stable release version in JVM Akka 2.4. Akka.Persistence is on-target to exit beta and become a fully mature module as of Akka.NET 1.5, due in May/June timeframe.

A quick note about 1.5 - JSON.NET will be replaced by Wire as the default serializer going forward, so if you want to be forward-compatible with 1.5 you will need to switch to using Wire today. Learn how to switch to using Wire as the default Akka.NET serializer.

If you install 1.0.7 you may see the following warning appear:

NewtonSoftJsonSerializer has been detected as a default serializer.
It will be obsoleted in Akka.NET starting from version 1.5 in the favor of Wire
for more info visit: http://getakka.net/docs/Serialization#how-to-setup-wire-as-default-serializer
If you want to suppress this message set HOCON {configPath} config flag to on.

This release also fixes some issues with the Cluster.Tools and Cluster.Sharding NuGet packages, which weren't versioned correctly in previous releases.

Fixes & Changes - Akka.NET Core

Fixes & Changes - Akka.Remote, Akka.Cluster, Et al

Fixes & Changes - Akka.Persistence

Commit Stats for v1.0.7

COMMITS	LOC+	LOC-	AUTHOR
12	1718	2213	Aaron Stannard
11	2187	2167	Silv3rcircl3
7	433	75	JeffCyr
6	2	1127	Danthar
6	10383	3054	Chris Constantin
3	510	25	maxim.salamatko
3	5	3	Christopher Martin
2	53	65	rogeralsing
2	50	1	mukulsinghsaini
2	2738	2035	Sean Gilliam
2	25	4	Bartosz Sypytkowski
2	2	2	utcnow
2	14	13	zbynek001
2	130	126	annymsMthd
1	58	0	Denis Kostikov
1	48	43	voltcode
1	213	66	Alex Koshelev
1	2	2	Tamas Vajk
1	2	2	Marc Piechura
1	2	1	Juergen Hoetzel
1	19	8	tstojecki
1	13	13	Willie Ferguson
1	1	1	ravengerUA

Assets 2

18 Jan 23:31

Aaronontheweb

v1.0.6

aff30fd

Akka.NET v1.0.6 Stable Release

1.0.6 January 18 2016

Maintenance release for Akka.NET v1.0.5
This patch consists of many bug fixes, performance improvements, as well as the addition of two brand new alpha modules for Akka.Cluster users.

Akka.Cluster.Tools and Akka.Cluster.Sharding
The biggest part of this release is the addition of Akka.Cluster.Tools and Akka.Cluster.Sharding, both of which are available now as pre-release packages on NuGet.

PM> Install-Package Akka.Cluster.Tools -pre

and

PM> Install-Package Akka.Cluster.Sharding -pre

Respectively, these two packages extend Akka.Cluster to do the following:

Distributed pub/sub (Akka.Cluster.Tools)
ClusterClient - subscribe to changes in cluster availability without actually being part of the cluster itself. (Akka.Cluster.Tools)
ClusterSingleton - guarantee a single instance of a specific actor throughout the cluster. (Akka.Cluster.Tools)
Sharding - partition data into durable stores (built on top of Akka.Persistence) in a manner that is fault-tolerant and recoverable across thecluster. (Akka.Cluster.Sharding)

Check out the documentation for more details!

Fixes & Changes - Akka.NET Core

Fixes & Changes - Akka.Remote & Akka.Cluster
It should be noted that we've improved the throughput from Akka.NET v1.0.5 to 1.0.6 by a factor of 8

Fixes & Changes - Akka.Persistence

A special thanks to all of our contributors for making this happen!
18 contributors since release v1.0.5

COMMITS	LOC+	LOC-	AUTHOR
22	3564	28087	Aaron Stannard
15	1710	1303	rogeralsing
6	569	95	Silv3rcircl3
6	53594	4417	Bartosz Sypytkowski
5	1786	345	Sean Gilliam
3	786	159	maxim.salamatko
2	765	277	JeffCyr
2	44	53	Chris Constantin
2	14	2	Simon Anderson
1	84	4	Bart de Boer
1	6051	27	danielmarbach
1	6	2	tstojecki
1	3	5	Ralf1108
1	27	0	Andrew Skotzko
1	2	2	easuter
1	2	1	Danthar
1	182	0	derwasp
1	179	0	Onat Yiğit Mercan

Assets 2

03 Dec 19:08

Aaronontheweb

v1.0.5

fcf07ec

Akka.NET v1.0.5 Stable Release

1.0.5 December 3 2015

Maintenance release for Akka.NET v1.0.4
This release is a collection of bug fixes, performance enhancements, and general improvements contributed by 29 individual contributors.

Fixes & Changes - Akka.NET Core

Fixes & Changes - Akka.Remote, Akka.Cluster

Fixes & Changes - Akka.Persistence

A special thanks to all of our contributors, organized below by the number of changes made:

23369 5258 18111 Aaron Stannard
18827 16329 2498 Bartosz Sypytkowski
11994 9496 2498 Steffen Forkmann
6031 4637 1394 maxim.salamatko
1987 1667 320 Graeme Bradbury
1556 1149 407 Sean Gilliam
1118 1118 0 moliver
706 370 336 rogeralsing
616 576 40 Marek Kadek
501 5 496 Alex Koshelev
377 269 108 Jeff Cyr
280 208 72 willieferguson
150 98 52 Christian Palmstierna
85 63 22 Willie Ferguson
77 71 6 Emil Ingerslev
66 61 5 Grover Jackson
60 39 21 Alexander Pantyukhin
56 33 23 Uladzimir Makarau
55 54 1 rdavisau
51 18 33 alex-kondrashov
42 26 16 Silv3rcircl3
36 30 6 evertmulder
33 19 14 Filip Malachowicz
13 11 2 Suhas Chatekar
7 6 1 tintoy
4 2 2 Jonathan
2 1 1 neekgreen
2 1 1 Christopher Martin
2 1 1 Artem Borzilov

Assets 2

08 Aug 00:29

Aaronontheweb

v1.0.4

683a7ec

Akka.NET v1.0.4 Stable Release

1.0.4 August 07 2015

Maintenance release for Akka.NET v1.0.3

Akka.IO
This release introduces some major new features to Akka.NET, including Akka.IO - a new set of capabilities built directly into the Akka NuGet package that allow you to communicate with your actors directly via TCP and UDP sockets from external (non-actor) systems.

If you want to see a really cool example of Akka.IO in action, look at this sample that shows off how to use the Telnet commandline to interact directly with Akka.NET actors.

Akka.Persistence.MongoDb and Akka.Persistence.Sqlite
Two new flavors of Akka.Persistence support are now available. You can install them via the commandline!

PM> Install-Package Akka.Persistence.MongoDb -pre

and

PM> Install-Package Akka.Persistence.Sqlite -pre

Fixes & Changes - Akka.NET Core

Akka.DI.StructureMap
We now have support for the StructureMap dependency injection framework out of the box. You can install it here!

PM> Install-Package Akka.DI.StructureMap

Assets 2

12 Jun 20:07

Aaronontheweb

v1.0.3

51f46a9

Akka.NET v1.0.3 Stable Release

Bugfix release for Akka.NET v1.0.2.

This release addresses an issue with Akka.Persistence.SqlServer and Akka.Persistence.PostgreSql where both packages were missing a reference to Akka.Persistence.Sql.Common.

In Akka.NET v1.0.3 we've packaged Akka.Persistence.Sql.Common into its own NuGet package and referenced it in the affected packages.

Assets 2

03 Jun 01:48

Aaronontheweb

v1.0.2

cf6863f

Akka.NET v1.0.2 Stable Release

1.0.2 June 2 2015

Bugfix release for Akka.NET v1.0.1.

Fixes & Changes - Akka.NET Core

Fixes & Changes - Akka.NET Dependency Injection

Fixes & Changes - Akka.Remote and Akka.Cluster

Fixes & Changes - Akka.Persistence

New Features:

Akka.TestKit.XUnit2
Akka.NET now has support for XUnit 2.0! You can install Akka.TestKit.XUnit2 via the NuGet commandline:

PM> Install-Package Akka.TestKit.XUnit2

Akka.Persistence.PostgreSql and Akka.Persistence.Cassandra
Akka.Persistence now has two additional concrete implementations for PostgreSQL and Cassandra! You can install either of the packages using the following commandline:

Akka.Persistence.PostgreSql Configuration Docs

PM> Install-Package Akka.Persistence.PostgreSql

Akka.Persistence.Cassandra Configuration Docs

PM> Install-Package Akka.Persistence.Cassandra

Akka.DI.StructureMap
Akka.NET's dependency injection system now supports StructureMap! You can install Akka.DI.StructureMap via the NuGet commandline:

PM> Install-Package Akka.DI.StructureMap

Assets 2

28 Apr 20:29

Aaronontheweb

v1.0.1

da937ac

Akka.NET v1.0.1 Stable Release

Bugfix release for Akka.NET v1.0.

Fixes:

New Features:

Akka.TestKit.NUnit
Akka.NET now has support for NUnit inside its TestKit. You can install Akka.TestKit.NUnit via the NuGet commandline:

PM> Install-Package Akka.TestKit.NUnit

Akka.Persistence.SqlServer
The first full implementation of Akka.Persistence is now available for SQL Server.

Read the full instructions for working with Akka.Persistence.SQLServer here.

Assets 2

09 Apr 22:28

Aaronontheweb

v1.0

ca7c5d1

Akka.NET v1.0 Stable Release

1.0.0 Apr 09 2015

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
Akka.NET Docs

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!

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!

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

ReceiveActors now support Async/Await out of the box.

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:

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:

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:

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:

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 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

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:

Assets 2

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

1.1.0 July 05 2016

1.0.8 April 26 2016

1.0.7 April 4 2016

1.0.6 January 18 2016

1.0.5 December 3 2015

1.0.4 August 07 2015

1.0.2 June 2 2015

1.0.0 Apr 09 2015

Releases: akkadotnet/akka.net

Akka.NET v1.1.0 Stable Release

1.1.0 July 05 2016

Akka.NET v1.0.8 Stable Release

1.0.8 April 26 2016

Akka.NET v1.0.7 Stable Release

1.0.7 April 4 2016

Akka.NET v1.0.6 Stable Release

1.0.6 January 18 2016

Akka.NET v1.0.5 Stable Release

1.0.5 December 3 2015

Akka.NET v1.0.4 Stable Release

1.0.4 August 07 2015

Akka.NET v1.0.3 Stable Release

Akka.NET v1.0.2 Stable Release

1.0.2 June 2 2015

Akka.NET v1.0.1 Stable Release

Akka.NET v1.0 Stable Release

1.0.0 Apr 09 2015