{"id":38653,"date":"2020-03-18T06:00:56","date_gmt":"2020-03-18T13:00:56","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/premier-developer\/?p=38653"},"modified":"2020-03-16T11:45:06","modified_gmt":"2020-03-16T18:45:06","slug":"sharing-grpc-protobuf-contracts-using-a-rest-endpoint","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/premier-developer\/sharing-grpc-protobuf-contracts-using-a-rest-endpoint\/","title":{"rendered":"Sharing gRPC ProtoBuf contracts using a REST endpoint"},"content":{"rendered":"

In this post, Premier Consultant Randy Patterson<\/a> explores ASP.NET Static File middleware as an option to distribute gRPC proto files.<\/p>\n

\n

Introduction<\/h2>\n

gRPC services require a service contract usually defined using the Protocol Buffer Language in proto files. The service contract is then used to generate your C# (or language of your choice)<\/em> server-side classes and your client side proxies. Sharing these proto contract files is necessary for generating these classes. However, there is no easy way to share these files other than copying them from the server to the client. Sharing files like this can be especially difficult in a Microservices architecture where there can be many different clients developed by many different teams. This post will walk you through the process of adding middleware to a gRPC server to deliver your proto files using a URL instead of files.<\/p>\n

Create Project<\/h2>\n

Create a new project and choose the gRPC Service Template using the latest version of .Net Core<\/p>\n

<\/p>\n

Add Middleware<\/h2>\n

Open the Startup.cs<\/em> file and modify the Configure<\/em> method<\/p>\n

First, add the StaticFIles<\/strong> middleware before app.UseRouting()<\/em> and configure it to only serve proto files located in the \/protos directory.<\/p>\n

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)\r\n{\r\n     . . . \r\n\r\n    \/\/only serve .proto files\r\n    var provider = new FileExtensionContentTypeProvider();\r\n    provider.Mappings.Clear();\r\n    provider.Mappings[\".proto\"] = \"text\/plain\";\r\n    app.UseStaticFiles(new StaticFileOptions\r\n    {\r\n        FileProvider = new PhysicalFileProvider(Path.Combine(env.ContentRootPath, \"Protos\")),\r\n        RequestPath = \"\/proto\",\r\n        ContentTypeProvider = provider\r\n\r\n    });\r\n\r\n    app.UseRouting();\r\n\r\n    . . .\r\n}}\r\n<\/pre>\n
Update Project File<\/h2>\n
Next, update the project file to copy the protos directory to the output<\/em> and publish directories<\/em><\/p>\n
Before the final <\/project> <\/strong>element in the .csproj<\/em> files add the following sections<\/p>\n
  <ItemGroup>\r\n    <Content Update=\"Protos\\*\">\r\n      <CopyToOutputDirectory>Always<\/CopyToOutputDirectory>\r\n    <\/Content>\r\n  <\/ItemGroup>\r\n\r\n  <ItemGroup>\r\n    <Content Include=\"Protos\\*\" CopyToPublishDirectory=\"PreserveNewest\" \/>\r\n  <\/ItemGroup>\r\n<\/pre>\n
This will copy all the files in the \/Protos<\/em> directory to your output and publish directories<\/p>\n
Run the application and navigate to http:\/\/localhost:5001\/proto\/greet.proto<\/a> . You should see the following screen.<\/p>\n
<\/p>\n
Much like WCF WSDL Endpoints to REST API Swagger endpoints, you now have gRPC endpoints that deliver the contract files to any client that needs them.<\/p>\n
Directory Browser<\/h2>\n
Optionally, you can add middleware to deliver a UI allowing a user to view all your proto<\/em> files and clicking on any file will display the contents.<\/p>\n
Back in your Startup.cs <\/em>files, add the following MiddleWare<\/p>\n
app.UseDirectoryBrowser(new DirectoryBrowserOptions\r\n{\r\n    FileProvider = new PhysicalFileProvider(Path.Combine(env.ContentRootPath, \"Protos\")),\r\n    RequestPath = \"\/proto\"\r\n});\r\n<\/pre>\n
Start your application and browse to the http:\/\/localhost:5001\/proto<\/a> URL and you should be presented with the following UI<\/p>\n
<\/p>\n
Conclusion<\/h2>\n
One of the challenges of implementing gRPC endpoints is distributing the required ProtoBuf contracts and updates to clients. There are several ways of accomplishing this including brute force method of copying the files to the client, NuGet Packages or network file shares. Delivering the contracts using a URL can make the services easier to use and discover. This can be crucial in a large micro-service architecture where you could have hundreds of contracts to manage. To view the full source code please visit https:\/\/github.com\/ranpatterson\/GrpcEndpoints<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
One of the challenges of implementing gRPC services is distributing the required ProtoBuf contracts and updates to clients. Delivering the contracts using a URL can make the services easier to use and discover. Learn how you can use ASP.NET Core static files middleware to distribute your proto files.<\/p>\n","protected":false},"author":582,"featured_media":37840,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[80,6699,5940,1],"tags":[61],"class_list":["post-38653","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-net","category-c","category-development","category-permierdev","tag-asp-net-core"],"acf":[],"blog_post_summary":"
One of the challenges of implementing gRPC services is distributing the required ProtoBuf contracts and updates to clients. Delivering the contracts using a URL can make the services easier to use and discover. Learn how you can use ASP.NET Core static files middleware to distribute your proto files.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts\/38653","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/users\/582"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/comments?post=38653"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts\/38653\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/media\/37840"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/media?parent=38653"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/categories?post=38653"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/tags?post=38653"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}