Github.com/dotnet/orleans

Orleans is a framework, provides a straight-forward approach to building distributed High-scale computing applications , without the need to learn and apply complex concurrency or other scaling patterns.

It was created by Microsoft implementing the Virtual Actor Model and designed for use in the cloud.

Orleans have been used extensively running in Microsoft Azure by several Microsoft product groups, most notably by 343 Indu Stries as a platform for all of the Halo 4 and Halo 5 cloud services, as well as by a number of the other projects and companies.

Installation

Installation is performed via NuGet. There is several packages, one for each different project type (interfaces, grains, silo, and client).

In the Grain Interfaces Project:

PM> Install-Package Microsoft.Orleans.OrleansCodeGenerator.Build

In the Grain implementations project:

PM> Install-Package Microsoft.Orleans.OrleansCodeGenerator.Build

In the server (silo) Project:

PM> Install-Package Microsoft.Orleans.Server

In the client project:

PM> Install-Package Microsoft.Orleans.Client

Official Builds

The stable production-quality release is located here.

The latest clean Development Branch build from CI is Located:here

Building from Source

Clone the sources from the GitHub repo

Run Run Build.cmd the script to build the binaries locally and then reference the required NuGet packages from Binaries\NuGet.Packages\* .

Documentation

Documentation is located here

Code Examples

Create an interface for your grain:

Orleans. igrainwithintegerkey{  task<SayHello (greeting);}  

Provide an implementation of the That interface:

Orleans.  ihello{task<SayHello (return Task.fromresult ($"you said: ' {greeting} ', I say:hello!");}} 

Call the grain from your Web service (or anywhere else):

Get a reference to the Ihello grain with Id ' 0 '. var friend = grainclient.grainfactory.getgrain<ihello> (0);  Send a greeting to the grain and await the response. Console.WriteLine (await friend.) SayHello ("Good morning, my friend!"));     

Community

• Ask questions by opening a issue on GitHub or on Stack Overflow

• Chat on Gitter

• Follow the @MSFTOrleans Twitter account for Orleans announcements.

• Orleanscontrib-repository of community add-ons to Orleans Various community projects, including Orleans monitoring, Desi GN Patterns, Storage Provider, etc.

• Guidelines for developers wanting to contribute code changes to Orleans.

• You is also encouraged to the report bugs or start a technical discussion by starting a new thread on GitHub.

License

This project is licensed under the MIT license.

Quick Links

• Msr-projectorleans
• Orleans Tech report-distributed Virtual Actors for programmability and Scalability
• Orleans-github
• Orleans Documentation
• Contributing

This project has adopted the Microsoft Open Source Code of conduct. For more information see the Code of Conduct FAQs or contact [e-mail protected] with any additional questions or co Mments

Github.com/dotnet/orleans