|
| 1 | +--- |
| 2 | +uid: akkadotnet-v15-whats-new |
| 3 | +title: What's new in Akka.NET v1.5.0? |
| 4 | +--- |
| 5 | + |
| 6 | +# Akka.NET v1.5 Plans and Goals |
| 7 | + |
| 8 | +Beginning with our [March 9th, 2022 Akka.NET Community Standup](xref:community-standups) we've shared our plans for the roadmap of Akka.NET v1.5. |
| 9 | + |
| 10 | +While not every technical detail is finalized yet, we do want to share the goals and some of the specific plans of what's included in this next minor version release of Akka.NET! |
| 11 | + |
| 12 | +## Goals |
| 13 | + |
| 14 | +<!-- markdownlint-disable MD033 --> |
| 15 | +<iframe width="560" height="315" src="https://www.youtube.com/embed/pZN1ugrJtJU" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> |
| 16 | +<!-- markdownlint-enable MD033 --> |
| 17 | + |
| 18 | +Based on feedback from Akka.NET users, here are the top priorities: |
| 19 | + |
| 20 | +1. **Better documentation and examples** - after simplifying the Akka.NET APIs around configuration and startup, modernizing all samples and deployment guidance is the biggest issue affecting end-users. |
| 21 | +2. **Improved Akka.Remote + Cluster.Sharding performance** - we want to go from ~350,000 msg/s to 1m+ msg/s in our `RemotePingPong` benchmark by changing the design of Akka.Remote's actors and optionally, replacing our transports. |
| 22 | +3. **Improved default serialization options** - Newtonsoft.Json sucks. Full stop. |
| 23 | +4. **Improved Akka.Cluster formation experience** - in layman's terms this means [releasing Akka.Management out of beta](https://github.com/akkadotnet/Akka.Management/discussions/417) and incorporating it into the Akka.Cluster literature and code samples. |
| 24 | +5. **Leveraging .NET 6+ primitives for improved performance** - thread execution, zero-allocation System.Memory data structures, and more. |
| 25 | +6. **Make CQRS a priority in Akka.Persistence** - tags are an especially weak area for Akka.Persistence right now, given that they require table scans. |
| 26 | +7. **Leverage Microsoft.Extensions more closely** - consume Microsoft.Extensions.Configuration from HOCON, allow Microsoft.Extensions.Logging interplay, and more. |
| 27 | +8. **Cleanup** - there are a lot of old constructs and that can be removed from Akka.NET. |
| 28 | + |
| 29 | +## How to Contribute |
| 30 | + |
| 31 | +Contributing to the v1.5 effort is somewhat different than our [normal maintenance contributions to Akka.NET](xref:contributing-to-akkadotnet),in the following ways: |
| 32 | + |
| 33 | +1. **Breaking binary compatibility changes are allowed so long as they are cost-justified** - contributors must be able to explain both the benefits and trade-offs involved in making this change in order for it to be accepted; |
| 34 | +2. **Wire compatibility must include a viable upgrade path** - if we're to introduce changes to the wire format of Akka.NET, contributors must demonstrate and document a viable upgrade path for end-users; and |
| 35 | +3. **Bigger bets are encouraged** - now is a good time to take some risks on the code base. So long as contributors can offer sound arguments for taking those bets (and this includes acknowledging and being realistic about trade-offs) then they should feel free to propose new changes that align with the 1.5 goals. |
| 36 | + |
| 37 | +### Good Areas for Contribution |
| 38 | + |
| 39 | +1. .NET 6 dual-targeting - there will be lots of areas where we can take advantage of new .NET 6 APIs for improved performance; |
| 40 | +2. Performance optimization - performance optimization around Akka.Remote, Akka.Persistence, Akka.Cluster.Sharding, DData, and core Akka will be prioritized in this release and there are _many_ areas for improvement; |
| 41 | +3. Akka.Hosting - there are lots of extension points and possibilities for making the APIs as expressive + concise as possible - we will need input from contributors to help make this possible; |
| 42 | +4. API Cleanup - there are lots of utility classes or deprecated APIs that can be deleted from the code base with minimal impact. Less is more; and |
| 43 | +5. New ideas and possibilities - this is a _great_ time to consider adding new features to Akka.NET. Be bold. |
| 44 | + |
| 45 | +> [!IMPORTANT] |
| 46 | +> Familiarize yourself with our [Akka.NET contribution guidelines](xref:contributing-to-akkadotnet) for best experience. |
| 47 | +
|
| 48 | +## Designs & Major Changes |
| 49 | + |
| 50 | +### Akka.Hosting |
| 51 | + |
| 52 | +We want to make Akka.NET something that can be instantiated more typically per the patterns often used with the Microsoft.Extensions.Hosting APIs that are common throughout .NET. |
| 53 | + |
| 54 | +```csharp |
| 55 | +using Akka.Hosting; |
| 56 | +using Akka.Actor; |
| 57 | +using Akka.Actor.Dsl; |
| 58 | +using Akka.Cluster.Hosting; |
| 59 | +using Akka.Remote.Hosting; |
| 60 | + |
| 61 | +var builder = WebApplication.CreateBuilder(args); |
| 62 | + |
| 63 | +builder.Services.AddAkka("MyActorSystem", configurationBuilder => |
| 64 | +{ |
| 65 | + configurationBuilder |
| 66 | + .WithRemoting("localhost", 8110) |
| 67 | + .WithClustering(new ClusterOptions(){ Roles = new[]{ "myRole" }, |
| 68 | + SeedNodes = new[]{ Address.Parse("akka.tcp://MyActorSystem@localhost:8110")}}) |
| 69 | + .WithActors((system, registry) => |
| 70 | + { |
| 71 | + var echo = system.ActorOf(act => |
| 72 | + { |
| 73 | + act.ReceiveAny((o, context) => |
| 74 | + { |
| 75 | + context.Sender.Tell($"{context.Self} rcv {o}"); |
| 76 | + }); |
| 77 | + }, "echo"); |
| 78 | + registry.TryRegister<Echo>(echo); // register for DI |
| 79 | + }); |
| 80 | +}); |
| 81 | + |
| 82 | +var app = builder.Build(); |
| 83 | + |
| 84 | +app.MapGet("/", async (context) => |
| 85 | +{ |
| 86 | + var echo = context.RequestServices.GetRequiredService<ActorRegistry>().Get<Echo>(); |
| 87 | + var body = await echo.Ask<string>(context.TraceIdentifier, context.RequestAborted).ConfigureAwait(false); |
| 88 | + await context.Response.WriteAsync(body); |
| 89 | +}); |
| 90 | + |
| 91 | +app.Run(); |
| 92 | +``` |
| 93 | + |
| 94 | +No HOCON. Automatically runs all Akka.NET application lifecycle best practices behind the scene. Automatically binds the `ActorSystem` and the `ActorRegistry`, another new 1.5 feature, to the `IServiceCollection` so they can be safely consumed via both actors and non-Akka.NET parts of users' .NET applications. |
| 95 | + |
| 96 | +This should be open to extension in other child plugins, such as Akka.Persistence.SqlServer: |
| 97 | + |
| 98 | +```csharp |
| 99 | +builder.Services.AddAkka("MyActorSystem", configurationBuilder => |
| 100 | +{ |
| 101 | + configurationBuilder |
| 102 | + .WithRemoting("localhost", 8110) |
| 103 | + .WithClustering(new ClusterOptions() |
| 104 | + { |
| 105 | + Roles = new[] { "myRole" }, |
| 106 | + SeedNodes = new[] { Address.Parse("akka.tcp://MyActorSystem@localhost:8110") } |
| 107 | + }) |
| 108 | + .WithSqlServerPersistence(builder.Configuration.GetConnectionString("sqlServerLocal")) |
| 109 | + .WithShardRegion<UserActionsEntity>("userActions", s => UserActionsEntity.Props(s), |
| 110 | + new UserMessageExtractor(), |
| 111 | + new ShardOptions(){ StateStoreMode = StateStoreMode.DData, Role = "myRole"}) |
| 112 | + .WithActors((system, registry) => |
| 113 | + { |
| 114 | + var userActionsShard = registry.Get<UserActionsEntity>(); |
| 115 | + var indexer = system.ActorOf(Props.Create(() => new Indexer(userActionsShard)), "index"); |
| 116 | + registry.TryRegister<Index>(indexer); // register for DI |
| 117 | + }); |
| 118 | +}) |
| 119 | +``` |
| 120 | + |
| 121 | +#### `ActorRegistry` |
| 122 | + |
| 123 | +As part of Akka.Hosting, we need to provide a means of making it easy to pass around top-level `IActorRef`s via dependency injection both within the `ActorSystem` and outside of it. |
| 124 | + |
| 125 | +The `ActorRegistry` will fulfill this role through a set of generic, typed methods that make storage and retrieval of long-lived `IActorRef`s easy and coherent: |
| 126 | + |
| 127 | +```csharp |
| 128 | +var registry = ActorRegistry.For(myActorSystem); // fetch from ActorSystem |
| 129 | +registry.TryRegister<Index>(indexer); // register for DI |
| 130 | +registry.Get<Index>(); // use in DI |
| 131 | +``` |
0 commit comments