SimpleFabric

The purpose of this project is to try to create a simple implementation of an API that approximates Microsoft Service Fabric, allowing you to use a similar programming model without necessarily giving you any benefits of scalability reliability, resilience, delivery guarantees, etc.

The idea is to make a platform where you can start out developing a throwaway project that is a runaway hit, which in turn makes it easy to move (code and data-wise) to a platform that is highly scalable and resilient.

Availability on Nuget

SimpleFabric is available on Nuget with these packages:

Setup

Some of this setup will deviate heavily from Microsoft Service Fabric, as the purpose of this implementation is hugely different from original Service Fabric. So this is not stuff you'll find in the official API. It is, however, stuff that happens before you start using the part of the SimpleFabric API that is meant to mimic the Service Fabric API.

Configuring the `ActorProxy`

You can select which kind of ActorProxy should be created. It defaults to the InMemoryActorProxy, which keeps a registry in process. While it is implicitly set to the default actor proxy, you could configure it by:

ActorProxy.ActorProxyType = ActorProxyType.InMemoryActorProxy;

This only works for proxy types in the core library. If you implement your own proxy type or get one from another library, you can add a ActorProxyCreator-Func:

ActorProxy.ActorProxyCreator = 
    () => { return new NetMQActorProxy(); }

This needs to be setup before you start running Create-calls on the ActorProxy.

Configuring the `StateManager` for the `Actor`

Similarly, you can configure the StateManager for the Actor, which defaults to being the InMemoryActorStateManager, which is a thin wrapper on a simple dictionary for storing state. This will not be persisted in any way, so it is useful for unit testing and prototyping.

Configure the StateManager:

Actor.StateManagerCreator = 
    () => { return new AzureTableStorageActorStateManager(); }

Persistent storage using Azure Table Storage

By adding the package for Azure Table Storage, you can setup using that as a backing store for SimpleFabric:

AzureTableStorageActorStateManager.TableStorageTable = "TABLENAME";
AzureTableStorageActorStateManager.TableStorageConnection = "CONNECTIONSTRING";
Actor.StateManagerCreator = () =>
{
	return new AzureTableStorageActorStateManager();
};

Alternatively, you can configure the table and connection in your app settings using:

<connectionStrings>
	<add name="SimpleFabric.AzureTableStorage.Connection" connectionString="INSERT CONNECTION STRING"/>
</connectionStrings>
<appSettings>
	<add key="SimpleFabric.AzureTableStorage.TableName" value="INSERT TABLE NAME" />
</appSettings>

Current state

The state of the library is highly experimental. I'll start using it for production work for stuff that is not mission critical any minute, but I urge you not to.

Priority

Actors (started)
- Actor creation
- Actor lifetime (Activation, Deactivation, KeepAlive on requests)
  - Actor activation and deactivation
- State in Azure Table Storage (started)
- Timers
- State stored to local disk
Stateless Services
Stateful Services

COCPORN/SimpleFabric