azure-sf-recipes
An API which provides basic CRUD operations for food recipies.
Architecture
Using Azure Service Fabic, this simple solution comprises of two microservices, an ASP.NET Core WebApi and a catalog service, responsible for maintaining state.
The API is a stateless service which can be have many instances, just update the Recipes.API_InstanceCount in ApplicationManifest.xml.
While, the catalog service is a stateful service, this service can be partitioned and provide high availability with replica set, again just update the values in ApplicationManifest.xml.
Requirements
- .NET Core 2.0
- Azure Service Fabric SDK
Note: Once Service Fabric SDK is installed, you can use the Service Fabric browser explorer in system task tray to view nodes, instances, partitions etc. Or alternativley, use Service Fabric Explorer application.
API endpoints
Post a recipe
http://localhost:8808/api/recipes
{
"id": "deba9f93-ac91-4c43-80c8-46f002954c71",
"name" : "Margherita Pizza",
"description" : "Classic Neapolitan pizza, made with San Marzano tomatoes, mozzarella, fresh basil and extra-virgin olive oil.",
"servings" : "2"
}Get all recipes
http://localhost:8808/api/recipes
Get a specific recipe
http://localhost:8808/api/recipes/deba9f93-ac91-4c43-80c8-46f002954c71
Patch a specific recipe
http://localhost:8808/api/recipes/deba9f93-ac91-4c43-80c8-46f002954c71
[{
"op": "replace",
"path": "/servings",
"value": "3"
}]Delete an existing recipe
http://localhost:8808/api/recipes/deba9f93-ac91-4c43-80c8-46f002954c71