Orleans.Clustering.Kubernetes 2.1.0

.NET Core 3.1 .NET Standard 2.0
NuGet\Install-Package Orleans.Clustering.Kubernetes -Version 2.1.0
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.
dotnet add package Orleans.Clustering.Kubernetes --version 2.1.0
<PackageReference Include="Orleans.Clustering.Kubernetes" Version="2.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Orleans.Clustering.Kubernetes --version 2.1.0
#r "nuget: Orleans.Clustering.Kubernetes, 2.1.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Orleans.Clustering.Kubernetes as a Cake Addin
#addin nuget:?package=Orleans.Clustering.Kubernetes&version=2.1.0

// Install Orleans.Clustering.Kubernetes as a Cake Tool
#tool nuget:?package=Orleans.Clustering.Kubernetes&version=2.1.0


A functional Kubernetes cluster is required for this provider to work. If you don't have one yet, there are multiple (and mostly complicated) ways to deploy Kubernetes for production use and it is out of scope of this provider as there are many articles around the web on how to do it. However, if you are playing with Docker and Kubernetes for the first time or you want to build a development box, Scott Hanselman has a nice article showing how to easily setup Docker for Windows with Kubernetes on your machine. Although it shows Windows 10, it can be easily adopted to Mac OSX as well.

Custom Resource Definitions

You need to apply both .yaml files from the package before starting the silo. It must be done once per Kubernetes cluster.

Note: You can also deploy the CRDs from the files on the Definitions directory on this repo.


Tell Orleans runtime that we are going to use Kubernetes as our Cluster Membership Provider:

var silo = new SiloBuilder()


Now that our silo is up and running, the Orleans client needs to connect to the Kubernetes to look for Orleans Gateways.

var client = new ClientBuilder()
        .UseKubeGatewayListProvider() // Optionally use the configure delegate to specify the namespace where you cluster is running.

The provider will discover the cluster based on the kubernetes namespace the silo pod is running. In the case of the client, if a configure delegate with the Namespace property set to a non-null value is specified, it will ignore the current running pod namespace and will try to use that namespace instead.

Great! Now enjoy your Orleans application running within a Kubernetes cluster without needing an external membership provider!

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Orleans.Clustering.Kubernetes:

Package Downloads

This library provides primitives to set up a configurable, application-agnostic Orleans silo and clients. Use it with the Orleans.Contrib.UniversalSilo.Templates to get started with Orleans.


Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.1.0 65,590 12/12/2021
2.0.0 160,819 6/11/2020
1.2.2 35,572 3/22/2020
1.2.1 28,109 2/9/2020
1.2.0 1,882 1/25/2020
1.1.1 63,264 7/9/2019
1.1.0 8,408 3/21/2019
1.0.20 19,391 10/23/2018
1.0.19 11,100 7/10/2018
1.0.18 4,292 3/28/2018
1.0.0-rc2-15 808 3/13/2018
1.0.0-rc1-13 749 3/6/2018
1.0.0-rc1-11 675 2/27/2018
1.0.0-preview-7 833 2/9/2018
1.0.0-preview-5 710 2/9/2018