Create your first C# Service Fabric stateful reliable services application
Learn how to deploy your first Service Fabric application for .NET on Windows in just a few minutes. When you're finished, you have a local cluster running with a reliable service application.
Before you get started, make sure that you have set up your development environment. This includes installing the Service Fabric SDK and Visual Studio 2017 or 2015.
Create the application
Launch Visual Studio as an administrator.
Create a project with
In the New Project dialog, choose Cloud > Service Fabric Application.
Name the application MyApplication and press OK.
You can create any type of Service Fabric application from the next dialog. For this Quickstart, choose Stateful Service.
Name the service MyStatefulService and press OK.
Visual Studio creates the application project and the stateful service project and displays them in Solution Explorer.
The application project (MyApplication) does not contain any code directly. Instead, it references a set of service projects. In addition, it contains three other types of content:
Profiles for deploying to different environments.
PowerShell script for deploying/upgrading your application.
Includes the ApplicationManifest.xml file under ApplicationPackageRoot which describes your application's composition. Associated application parameter files are under ApplicationParameters, which can be used to specify environment-specific parameters. Visual Studio selects an application parameter file that's specified in the associated publish profile during deployment to a specific environment.
For an overview of the contents of the service project, see Getting started with Reliable Services.
Deploy and debug the application
Now that you have an application, run it.
In Visual Studio, press
F5 to deploy the application for debugging.
The first time you run and deploy the application locally, Visual Studio creates a local cluster for debugging. This may take some time. The cluster creation status is displayed in the Visual Studio output window.
When the cluster is ready, you get a notification from the local cluster system tray manager application included with the SDK.
Once the application starts, Visual Studio automatically brings up the Diagnostics Event Viewer, where you can see trace output from your services.
The stateful service template used shows a counter value incrementing in the
RunAsync method of MyStatefulService.cs.
Expand one of the events to see more details, including the node where the code is running. In this case, it is _Node_0, though it may differ on your machine.
The local cluster contains five nodes hosted on a single machine. In a production environment, each node is hosted on a distinct physical or virtual machine. To simulate the loss of a machine while exercising the Visual Studio debugger at the same time, let's take down one of the nodes on the local cluster.
In the Solution Explorer window, open MyStatefulService.cs.
RunAsync method and set a breakpoint on the first line of the method.
Launch the Service Fabric Explorer tool by right-clicking on the Local Cluster Manager system tray application and choose Manage Local Cluster.
Service Fabric Explorer offers a visual representation of a cluster. It includes the set of applications deployed to it and the set of physical nodes that make it up.
In the left pane, expand Cluster > Nodes and find the node where your code is running.
Click Actions > Deactivate (Restart) to simulate a machine restarting.
Momentarily, you should see your breakpoint hit in Visual Studio as the computation you were doing on one node seamlessly fails over to another.
Next, return to the Diagnostic Events Viewer and observe the messages. The counter has continued incrementing, even though the events are actually coming from a different node.
Cleaning up the local cluster (optional)
Remember, this local cluster is real. Stopping the debugger removes your application instance and unregisters the application type. However, the cluster continues to run in the background. When you're ready to stop the local cluster, there are a couple options.
Keep application and trace data
Shut down the cluster by right-clicking on the Local Cluster Manager system tray application and then choose Stop Local Cluster.
Delete the cluster and all data
Remove the cluster by right-clicking on the Local Cluster Manager system tray application and then choose Remove Local Cluster.
If you choose this option, Visual Studio will redeploy the cluster the next time your run the application. Choose this option if you don't intend to use the local cluster for some time or if you need to reclaim resources.
Read more about reliable services.