Akka.Discovery 1.5.15

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

// Install Akka.Discovery as a Cake Tool
#tool nuget:?package=Akka.Discovery&version=1.5.15                

Akka.NET

Akka.NET logo

Akka.NET Discord server NuGet Nuget

Akka.NET is a .NET port of the popular Akka project from the Scala / Java community. We are an idiomatic .NET implementation of the actor model built on top of the .NET Common Language Runtime.

Akka.NET is a .NET Foundation project.

.NET Foundation Logo

How is Akka.NET Used?

Akka.NET can be used in-process or inside large, distributed real-time systems; we support a wide variety of use cases.

Akka.NET can be used to solve the following types of problems:

  1. Concurrency - Akka.NET actors only process messages one-at-a-time and they do so in first in, first out (FIFO) order; this means that any application state internal to an actor is automatically thread-safe without having to use locks or any other shared-memory synchronization mechanisms.
  2. Stream Processing - Akka.NET actors and Akka.Streams make it easy to build streaming applications, used for processing incoming streams of data or incoming streams of live events such as UI or network events inside native applications.
  3. Event-Driven Programming - actors make it easy to build event-driven applications, as actors' message-processing routines naturally express these types of designs.
  4. Event Sourcing and CQRS - Akka.Persistence, used by actors to make their state re-entrant and recoverable across restarts or migrations between nodes, natively supports event sourcing. Akka.Persistence.Query can be used to compute CQRS-style projections and materialized views from Akka.Persistence data.
  5. Location Transparency - Akka.Remote makes it simple for actors in remote processes to transparently communicate with each other.
  6. Highly Available, Fault-Tolerant Distributed Systems - Akka.Cluster, Akka.Cluster.Sharding, and other tools built on top of Akka.Cluster make it possible to build highly available and fault-tolerant distributed systems by leveraging peer-to-peer programming models with topology-aware message routing and distribution.
  7. Low Latency, High Throughput - Akka.NET aims to be low latency and high throughput, processing 10s millions of messages per second in-memory and hundreds of thousands of messages per second over remote connections.

Where Can I Learn Akka.NET?

You can start by taking the Akka.NET Bootcamp, but there are many other great learning resources for Akka.NET Online.

Build Status

Stage Status
Build Build Status
NuGet Pack Build Status
.NET Framework Unit Tests Build Status
.NET 7 Unit Tests (Windows) Build Status
.NET 7 Unit Tests (Linux) Build Status
.NET 7 MultiNode Tests (Windows) Build Status
.NET 7 MultiNode Tests (Linux) Build Status
Docs Build Status

Install Akka.NET via NuGet

If you want to include Akka.NET in your project, you can install it directly from NuGet

To install Akka.NET Distributed Actor Framework, run the following command in the Package Manager Console

PM> Install-Package Akka.Hosting

Akka.Hosting includes the base Akka NuGet package and also provides an easy interface to integrate Akka.NET with the most-used parts of the Microsoft.Extensions ecosystem: Configuration, Logging, Hosting, and DependencyInjection. We encourage developers to adopt it.

And if you need F# support:

PM> Install-Package Akka.FSharp

Akka.NET Project Templates

To create your own Akka.NET projects using our templates (Akka.Templates), install them via the dotnet CLI:

dotnet new install "Akka.Templates::*"

This will make our templates available via dotnet new on the CLI and as new project templates inside any .NET IDE such as Visual Studio or JetBrains Rider. You can view the full list of templates included in our package here: https://github.com/akkadotnet/akkadotnet-templates#available-templates

Builds

Please see Building Akka.NET.

To access nightly Akka.NET builds, please see the instructions here.

Support

If you need help getting started with Akka.NET, there's a number of great community resources online:

If you and your company are interested in getting professional Akka.NET support, you can contact Petabridge for dedicated Akka.NET support.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  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 netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework 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 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.
  • .NETStandard 2.0

  • net6.0

NuGet packages (9)

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

Package Downloads
Akka.Cluster.Tools

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

Akka.Management

Akka cluster management module for Akka.NET

Akka.Discovery.KubernetesApi

Akka.NET discovery module for Kubernetes

Akka.Discovery.Azure

Akka.NET Service Discovery for Azure-hosted services. Works with App Service, Container Apps, and more.

Akka.Management.Cluster.Bootstrap

Cluster bootstrap module for Akka.NET

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.5.33 604 12/23/2024
1.5.32 5,678 12/4/2024
1.5.31 14,653 11/11/2024
1.5.30 19,104 10/3/2024
1.5.29 2,082 10/1/2024
1.5.28 33,716 9/4/2024
1.5.28-beta1 224 8/23/2024
1.5.27.1 50,590 7/26/2024
1.5.27 539 7/25/2024
1.5.27-beta2 2,992 7/3/2024
1.5.27-beta1 245 7/3/2024
1.5.26 41,229 6/27/2024
1.5.25 7,560 6/14/2024
1.5.24 3,356 6/7/2024
1.5.23 535 6/6/2024
1.5.22 846 6/3/2024
1.5.21 635 5/28/2024
1.5.20 841 4/29/2024
1.5.19 13,313 4/15/2024
1.5.18 3,781 3/12/2024
1.5.17.1 10,585 3/2/2024
1.5.17 535 2/29/2024
1.5.16 3,246 1/29/2024
1.5.15 12,318 1/10/2024
1.5.14 3,258 11/3/2023
1.5.13 4,564 9/18/2023
1.5.13-beta1 130 8/25/2023
1.5.12 4,688 8/2/2023
1.5.11 789 7/27/2023
1.5.10 593 7/25/2023
1.5.9 778 7/17/2023
1.5.8 1,323 6/15/2023
1.5.7 34,829 5/17/2023
1.5.6 584 5/8/2023
1.5.5 2,917 5/4/2023
1.5.4 830 4/25/2023
1.5.3 625 4/20/2023
1.5.2 648 4/6/2023
1.5.1 748 3/15/2023
1.5.0 7,604 3/2/2023
1.5.0-beta6 386 3/1/2023
1.5.0-beta5 182 3/1/2023
1.5.0-beta4 153 2/28/2023
1.5.0-beta3 136 2/27/2023
1.5.0-beta2 153 2/23/2023
1.5.0-beta1 174 2/20/2023
1.5.0-alpha4 473 2/1/2023
1.5.0-alpha3 151 11/15/2022
1.5.0-alpha2 200 10/17/2022
1.5.0-alpha1 161 8/22/2022
1.4.51 556 6/28/2023
1.4.50 646 3/15/2023
1.4.49 5,242 1/27/2023
1.4.49-beta1 164 1/11/2023
1.4.48 9,039 1/5/2023
1.4.47 1,212 12/9/2022
1.4.46 2,467 11/15/2022
1.4.45 3,523 10/19/2022
1.4.44 872 10/17/2022
1.4.43 1,626 9/27/2022
1.4.42 882 9/23/2022
1.4.41 1,438 8/31/2022
1.4.40 3,827 7/22/2022
1.4.39 1,499 6/1/2022
1.4.38 1,123 5/6/2022
1.4.37 1,659 4/14/2022
1.4.36 1,056 4/5/2022
1.4.35 1,039 3/18/2022
1.4.34 863 3/7/2022
1.4.33 1,152 2/14/2022
1.4.32 1,118 1/18/2022
1.4.31 1,284 12/21/2021
1.4.30 747 12/20/2021
1.4.29 911 12/13/2021
1.4.28-beta 10,882 11/10/2021
1.4.27-beta 493 10/11/2021
1.4.26-beta 223 9/28/2021
1.4.25-beta 12,480 9/8/2021
1.4.24-beta 253 8/17/2021
1.4.23-beta 243 8/10/2021
1.4.22-beta 248 8/5/2021
1.4.21-beta1 1,221 6/4/2021
1.4.21-beta 247 6/16/2021
1.4.20-beta 243 5/12/2021
1.4.19-beta 231 4/28/2021
1.4.18-beta 259 3/23/2021
1.4.17-beta 264 3/10/2021
1.4.16-beta 256 1/22/2021
1.4.15-beta 260 1/20/2021
1.4.14-beta 284 12/30/2020
1.4.13-beta 311 12/16/2020
1.4.12-beta 295 11/16/2020

Akka.NET v1.5.15 is a significant release for Akka.NET with some major feature additions and changes.
[Introducing `Akka.Analyzers` - Roslyn Analysis for Akka.NET](https://getakka.net/articles/debugging/akka-analyzers.html)
[Akka.Cluster.Sharding: perf optimize message extraction, automate `StartEntity` and `ShardEnvelope` handling](https://github.com/akkadotnet/akka.net/pull/6863)
[Akka.Cluster.Tools: Make `ClusterClient` messages be serialized using `ClusterClientMessageSerializer`](https://github.com/akkadotnet/akka.net/pull/7032)
[Akka.Persistence: Fix `LocalSnapshotStore` Metadata Fetch to ensure persistenceid match.](https://github.com/akkadotnet/akka.net/pull/7040)
[Akka.Delivery: Fix `ProducerControllerImpl<T>` state bug](https://github.com/akkadotnet/akka.net/pull/7034)
[Change MS.EXT and System package versioning to range](https://github.com/akkadotnet/akka.net/pull/7029) - we now support all Microsoft.Extensions packages from `(6.0,]`.
[Akka.Serialization: `INoSerializationVerificationNeeded` does not handle `IWrappedMessage` correctly](https://github.com/akkadotnet/akka.net/pull/7010)
Akka.Analyzers**
The core Akka NuGet package now references [Akka.Analyzers](https://github.com/akkadotnet/akka.analyzers), a new set of Roslyn Code Analysis and Code Fix Providers that we distribute via NuGet. You can [see the full set of supported Akka.Analyzers rules here](https://getakka.net/articles/debugging/akka-analyzers.html).
Akka.Cluster.Sharding Changes**
In [#6863](https://github.com/akkadotnet/akka.net/pull/6863) we made some major changes to the Akka.Cluster.Sharding API aimed at helping improve Cluster.Sharding's performance _and_ ease of use. However, these changes _may require some effort on the part of the end user_ in order to take full advantage:
[`ExtractEntityId`](https://getakka.net/api/Akka.Cluster.Sharding.ExtractEntityId.html) and [`ExtractShardId`](https://getakka.net/api/Akka.Cluster.Sharding.ExtractShardId.html) have been deprecated as they _fundamentally can't be extended and can't benefit from the performance improvements introduced into Akka.NET v1.5.15_. It is **imperative** that you migrate to using the [`HashCodeMessageExtractor`](https://getakka.net/api/Akka.Cluster.Sharding.HashCodeMessageExtractor.html) instead.
You no longer need to handle [`ShardRegion.StartEntity`](https://getakka.net/api/Akka.Cluster.Sharding.ShardRegion.StartEntity.html) or [`ShardingEnvelope`](https://getakka.net/api/Akka.Cluster.Sharding.ShardingEnvelope.html) inside your `IMessageExtractor` implementations, and in fact [`AK2001`](https://getakka.net/articles/debugging/rules/AK2001.html) (part of Akka.Analyzers) will automatically detect this and remove those handlers for you. Akka.NET automatically handles these two message types internally now.
ClusterClient Serialization Changes**
In [#7032](https://github.com/akkadotnet/akka.net/pull/7032) we solved a long-standing serialization problem with the [`ClusterClient`](https://getakka.net/api/Akka.Cluster.Tools.Client.ClusterClient.html) where  `Send`, `SendToAll`, and `Publish` were not handled by the correct internal serializer. This has been fixed by default in Akka.NET v1.5.15, but this can potentially cause wire compatibility problems during upgrades - therefore we have introduced a configuration setting to toggle this:
```hocon
# re-enable legacy serialization
akka.cluster.client.use-legacy-serialization = on
```
That setting is currently set to `on` by default, so v1.5.15 will still behave like previous versions of Akka.NET. However, if you have been affected by serialization issues with the `ClusterClient` (such as [#6803](https://github.com/akkadotnet/akka.net/issues/6803)) you should toggle this setting to `off`.
See "[Akka.NET v1.5.15 Upgrade Advisories](https://getakka.net/community/whats-new/akkadotnet-v1.5-upgrade-advisories.html)" for full details on some of the things you might need to do while upgrading to this version of Akka.NET.
You can [see the full set of changes for Akka.NET v1.5.15 here](https://github.com/akkadotnet/akka.net/milestones/1.5.15).
| COMMITS | LOC+ | LOC- | AUTHOR |
| --- | --- | --- | --- |
| 16 | 2228 | 1490 | Aaron Stannard |
| 9 | 9 | 9 | dependabot[bot] |
| 2 | 610 | 173 | Gregorius Soedharmo |
| 2 | 337 | 0 | Drew |
| 2 | 124 | 118 | Lehonti Ramos |
| 1 | 2 | 2 | Sergey Popov |
| 1 | 108 | 25 | Yaroslav Paslavskiy |
| 1 | 1 | 1 | Bert Lamb |