Azure/service-fabric-aspnetcore
This repo contains ASP.NET Core integration for Service Fabric Reliable Services.
The Microsoft.ServiceFabric.Services.AspNetCore.* NuGet packages contain implementations of ICommunicationListener that start the ASP.NET Core web host for either Kestrel or WebListener in a Service Fabric Reliable Service. The ICommunicationListener allows you to configure IWebHost, and then it manages its lifetime.
This repo builds the following packages:
- Microsoft.ServiceFabric.Services.AspNetCore
- Microsoft.ServiceFabric.Services.AspNetCore.Kestrel
- Microsoft.ServiceFabric.Services.AspNetCore.WebListener
These packages are documented here.
Getting Started
Prerequesites
Each project is a normal C# Visual Studio 2015 project. At minimum, you need MSBuild 14, PowerShell, and .NET Framework 4.5.2 to build and generate NuGet packages.
We recommend installing Visual Studio 2015 or Visual Studio 2017 which will set you up with all the .NET build tools and allow you to open the solution files. Community Edition is free and can be used to build everything here.
Build
To build everything and generate NuGet packages, run the build.ps1 script. NuGet packages will be dropped in a drop directory at the repo root.
Each project can also be built individually directly through Visual Studio or by running the solution file through MSBuild.
Development
Please refer to Readme.md at the Service Fabric home repo to learn more about our development process.
Releases and Support
Official releases from Microsoft of the NuGet packages in this repo are released directly to NuGet and Web Platform Installer. Get the latest official release here.
Only officially released NuGet packages from Microsoft are supported for use in production. If you have a feature or bug fix that you would like to use in your application, please issue a pull request so we can get it into an official release.
Reporting issues and feedback
Please refer to Contributing.md at the Service Fabric home repo for details on issue reporting and feedback.
Contributing code
If you would like to become an active contributor to this project please follow the instructions provided in Microsoft Azure Projects Contribution Guidelines.
For details on contributing to Service Fabric projects, please refer to Contributing.md at the Service Fabric home repo for details on contributing code.
Documentation
Service Fabric has a rich set of conceptual and reference documentation available at https://docs.microsoft.com/azure/service-fabric.
The ASP.NET Core integration packages are documented at https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-services-communication-aspnetcore.
Samples
For Service Fabric sample code, check out the Azure Code Sample gallery or go straight to Azure-Samples on GitHub.
License
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.