All-Jokes Project

This project was presented at .NET User Group Meetup (September 2018) and represents a Service Fabric application.

Content

The following source code contains:

• JokesApi/ - ASP.NET Core Web API service implemented as Service Fabric stateful service. The reliable state is used to store service data.
• JokesStats/ - .NET Core based statistics service implemented as Service Fabric actor. The actor state is used to store statistics.
• JokesWeb/ - ASP.NET Core MVC application implemented as Service Fabric stateless service.
• JokesApp/ - Service Fabric application project (combines JokesWeb & JokesApi)
• JokesApiContracts/ - shared models used for communication between JokesApi & JokesWeb
• JokesStats.Interfaces/ - JokesStats actor interface and models

Building demo project

This project is created using Visual Studio 2017 (15.8) and requires Azure Service Fabric SDK (3.2.176) to run.

Preparing the development machine

• Install .NET Core SDK (Windows). https://www.microsoft.com/net/download/windows
• Install Azure Service Fabric SDK (Windows). https://azure.microsoft.com/en-us/downloads

Build & Deploy

• Clone the master branch. git clone https://github.com/OlegKarasik/dotnet-user-group-2018-introduction-to-service-fabric <path to the local folder>
• Create local Service Fabric cluster. Use Five Nodes configuration
• Execute build-and-run.ps1. This will build and deploy JokesApp to local Service Fabric cluster (run PowerShell with administrative privileges)

Developer's comment:

The base path to JokesWebService in Service Fabric Explorer is http://localhost:19080/Explorer/index.html#/AppType/JokesAppType/app/JokesApp/service/JokesApp%252FJokesWebService

Application Usage

There are several .json files in mock-data/ directory that contains demo jokes. Feel free to use application Import functionality.

Developer's comment:

Please note. This demo application doesn't implement error handling. So be careful.

You can also create your own category of jokes. In order to do this you need to:

1. Create a .json with jokes.
2. Create an object of JokesApiServiceType service with the name composed as language/category with naming partitioning schema and single partition with category name.
3. Import the .json file.

See Also

• Service Fabric Explorer documentation. https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-visualizing-your-cluster

Authors

This project is owned by Coherent Solutions.

License

This project is licensed under the MIT License - see the LICENSE.md for details.