Skip to content
gRPC for .NET
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build Create gPRC HttpClient project and HttpClientFactory integration (#142) Mar 24, 2019
doc Migration cleanup Feb 1, 2019
examples Create gPRC HttpClient project and HttpClientFactory integration (#142) Mar 24, 2019
keys Migration cleanup Feb 1, 2019
kokoro Run interop tests against grpc-dotnet (#171) Mar 19, 2019
perf Update benchmark scenario names (#178) Mar 19, 2019
src Add logging of gRPC methods during binding (#184) Mar 25, 2019
test Add logging of gRPC methods during binding (#184) Mar 25, 2019
testassets
.gitattributes Add scripts to setup and update local feeds Feb 4, 2019
.gitignore
.travis.yml Required changes for 3.0.0 preview3 (#112) Feb 21, 2019
AUTHORS
CODE-OF-CONDUCT.md initial repo setup Nov 28, 2018
Directory.Build.props Generate xml documentation on build (#130) Feb 27, 2019
Grpc.AspNetCore.sln Create gPRC HttpClient project and HttpClientFactory integration (#142) Mar 24, 2019
LICENSE initial repo setup Nov 28, 2018
README.md
build_and_test.sh
global.json React to changes in the latest .NET Core SDK (#172) Mar 18, 2019

README.md

gRPC for .NET

Preview out!

A preview of gRPC for ASP.NET Core is on NuGet. A template using the preview shipped with .NET Core 3.0 Preview 3.

See https://github.com/grpc/grpc for the official version of gRPC C# (ready for production workloads).

The Plan

We plan to implement a fully-managed version of gRPC for .NET that will be built on top of ASP.NET Core HTTP/2 server. Here are some key features:

  • API compatible with the existing gRPC C# implementation (your existing service implementations should work with minimal adjustments)
  • Fully interoperable with other gRPC implementations (in other languages and other platforms)
  • Good integration with the rest of ASP.NET Core ecosystem
  • High-performance (we plan to utilize some of the cutting edge performance features from ASP.NET Core and in .NET platform itself)
  • We plan to provide a managed .NET Core client as well (possibly with limited feature set at first)

We are committed to delivering the managed server experience Microsoft.AspNetCore.Server functionalities in ASP.NET Core 3.0 timeframe. We will strive to also deliver the mananged client experience in 3.0.

See doc/packages.md for the planned package layout for both gRPC C# native (the current official version) and the new fully-managed gRPC for ASP.NET Core.

Please note that we plan both implementations (gRPC C# native and fully-managed gRPC for .NET Core) to coexist, there are currently no plans for one implementation to replace the other one.

To start using gRPC for ASP.NET Core

Documentation and guides are coming soon! In the mean time we suggest creating a basic website using the gRPC for ASP.NET template that comes with .NET Core 3.0 and refer to the examples at https://github.com/grpc/grpc-dotnet/tree/master/examples/Server.

To develop gRPC for ASP.NET Core

Installing .NET Core SDK:

# Run this script before building the project.
./build/get-dotnet.sh or ./build/get-dotnet.ps1

Setting up local feed with unreleased Grpc.* packages:

# We may depend on unreleased Grpc.* packages.
# Run this script before building the project.
./build/get-grpc.sh or ./build/get-grpc.ps1

To build:

dotnet build Grpc.AspNetCore.sln

To run tests:

dotnet test Grpc.AspNetCore.sln

To contribute

Contributions are welcome!

General rules for contributing to the gRPC project apply for this repository.

You can’t perform that action at this time.