Orleans Documentation

Samples Overview

What do I need?

To productively use the Orleans samples, please follow the Prerequisites section for the supported versions of the .NET framework, Visual Studio and Azure SDK. An Azure subscription will help with some of the samples, but is not required. For the Azure-based samples, you will need to install the SDK.

The samples themselves can be downloaded from GitHub.

Hello World

This is the Orleans version of an old classic. It demonstrates that while there is no such thing as “trivial” when you are dealing with distributed computing, Orleans makes it pretty straight-forward.

Azure Web Sample

An Azure-hosted version of Hello World.

Adventure

Before there was graphical user interfaces, before the era of game consoles and massive-multiplayer games, there were VT100 terminals and there was Colossal Cave Adventure. Possibly lame by today’s standards, back then it was a magical world of monsters, chirping birds, and things you could pick up. It’s the inspiration for this sample.

Presence Service

This sample shows the principles behind a typical (though much simplified) presence service, such as you would find in online games and other social applications.

Tic Tac Toe

This is a simple online version of the classic board game.

Chirper

A simple social network pub/sub system, with chirp messages being sent from publishers to followers.

Twitter Sentiment

This sample uses Orleans to aggregate and analyze twitter data for a simple sentiment dashboard. Twitter Sentiment relies on a Node.js project for some of its functionality, as well as Twitter developer credentials. To use this sample, you will need to:

  1. Get the Node.js Tools for Visual Studio
  2. Get a Twitter account
  3. Sign up as a Twitter Developer.

GPS Tracker

A combination of Orleans and SignalR is used to simulate GPS devices tracked as they move around San Francisco, updating their locations as they change.

Storage Providers

This sample contains sample code for two Orleans storage providers: one that stores data in a regular file system, one that connects to MongoDB.