.Net Foundation On .NET, 23 Jun 2020

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: ASP.NET Core Series: High performance requests with gRPC

Description

gRPC is a language agnostic, high-performance Remote Procedure Call (RPC) framework.

Sourabh Shirhatti comes on the show to give us a look at what the experience is like for a developer to creating a gRPC service with ASP.NET Core.

[00:35] - What is gRPC
[01:45] - What can you do with gRPC?
[04:00] - Creating a new gRPC service
[05:50] - Generating service stubs with protocol buffers.
[09:04] - Implementing the service
[12:52] - When should you use gRPC?

gRPC
https://grpc.io/

Get started with a gRPC service
https://docs.microsoft.com/aspnet/core/tutorials/grpc/grpc-start?WT.mc_id=ondotnet-c9-cephilli

Introduction to gRPC on .NET Core
https://docs.microsoft.com/en-us/aspnet/core/grpc?WT.mc_id=ondotnet-c9-cephilli

A

Hello friends welcome to another so on.net today, I have a shrub with me and we're here to talk about dot neck or in gr. Pc come and find out more.

A

Hello, everyone welcome back. This is another show on on.net and today, I have sir rapture at it with me. He's part of the.net core team and he's here to talk to us about GRP C and.net core right. What is gr PC so.

B

Your PC is a framework for remote procedure, calls okay. So ever since people made computers, they wanted to make computers talk to each other. So a good RPC framework would give us semantics for making remote calls, but make it a pure like it was local great. So ideally, I would just call a method like I normally would, except it would execute somewhere else right.

A

B

Your PC is a framework that lets me do that great.

A

B

Your PC was born out of the stubby project at Google. Okay and your PC is the open source variant. It's based on similar, it's based on that very slightly different okay, and so what we've done in on the.net team is: we've actually been partnering with a couple of folks at Google, a couple of folks at the cloud native computing foundation to donate cord to the CN CF, to make a performant, your PC stack, on.net core awesome.

A

So we're working with people across different orgs and the cloud native foundation to make a gr PC on dot neck or the new framework to you to do stuff. Now, what can I do with gr PC today, if I wanted to write something? What's a good example for a gr, PC solution.

B

Serger, pcs, uh opinionated, okay, it gives you four like I, guess: low-level primitives mm-hmm you have unity, calls where I send a request single request: I get single response back from the server okay, I have client streaming. I can send multiple messages to the server okay and get as the client and get back a single response. Sure I have service streaming, which is that flipped I send one message and they get back multiple messages: okay, as well as full duplex communication right.

A

B

Based on those four primitives type types of calls, you can pretty much build any work or, on top of your PC and.

A

That works over HTTP am I correct. So yes, so GPC.

B

Uses HDPE to is the transport layer, okay,.

A

So, yes, is that supported by all operating systems and all browsers and stuff, like that, Oh.

B

Most modern operating system supported browser support is a little different okay, because, while browsers themselves might use HTTP mm-hmm, the browser API is that you can consume like as a javascript is a client-side JavaScript developer right.

A

B

Not give you access to the full fidelity HTTP framing right, so what we care about more is like xhr or fetch. Do those api is give me full semantics to do HTTP? The answer is no okay,.

A

So no i6, folks, just more than browsers right! Well, even.

B

Know just to clarify you cannot do to your PC from a Morden browser. Okay, so we view it very much as a service to service like as a premier technology for service to service good.

A

B

There are some efforts, and you know there isn't an alternative protocol called G RPC web, which shares the same routes as your PC, but at the loss of some functionality is able to do of the limited subset of that. The browser API is okay and in addition to the GR PC stuff, they were shipping. We actually are as an experiment. Shipping preview support for our PC web.

A

Today, great so we actually see an example of GRP seen action yeah. Absolutely, let's do we're. Gonna show us the so.

B

I'm going to show you a simple GPC application: okay, so for folks who aren't aware, we've been shipping jar PC since dotnet core 3.0, perfect.

A

B

We ship with templates in the SDK fantastic, so I, would what I've already done, but I'll just so you see this I have there's a GPC template in the box, so you can dartnet new gr, PC I've.

A

B

Created your PC server project, okay,.

A

B

I can go ahead and run this, so you know it so it's built on top of the asp.net app model right.

A

B

Folks, who've never seen this. This output should look familiar that, like hey this looks a lot like asp.net yeah. It actually is built on top of asp.net right.

A

B

I can jump over here and I can go to the JIRA PC server project mm-hm and if you see startup, looks very similar, sorry and I meant program. It looks very similar and then start up. You will see, I have add your PC and my configure services.

A

B

I have mapped your PC.

A

Service, so if I had a like silly question, but if I have a dotnet core website can I just go into services and not gr PC as well and then create another end. Point I can also served your.

B

Pc over there, so it actually integrates in the end point routing, so you actually see uh-huh. This also has an HTTP endpoint. Yes,.

A

B

Is just something we've put in the template that says: hey cuz when you open it in the browser just to let you know you can't do it through the browser right. Oh yeah,.

A

B

This application does have an HTTP, endpoint manager, PC service, great there. You go so now, you're like what is this reader service right? Yes,.

A

B

Let's actually hop over from the chord to the IDL file: okay, D, so gr PC. While it's agnostic of the idea format, the canonical usages, protobuf right.

A

B

What I've opened is the protobuf file, so here's my file through throat, oh and.

C

B

Contains two things of interest: okay, it contains my RPC definition right and it contains definitions for the message types used by that RPC right.

A

So that's like a contract. Yes,.

B

It is, it is exactly that this is my contract. There.

A

B

Contract right so, first, let's look at the service definition right. Yes,.

C

B

I have a service called greeter and you see I have a unity, RPC call call say hello yep, it takes a Hello request and.

A

B

A Hello reply, perfect and as for what these types are, we actually have them defined right here, fantastic.

A

B

Stuff, so what you do is your PC is opinionated in that it is contract. First, okay,.

A

B

You first write the shape of what your RPC would look like, and then there are core generation tools, not just net, but across all other languages in run times as well. Right.

A

B

You can generate both the message types and either service stubs. If you're writing the service side of it or like client proxies, you can actually make those goals. Brilliant.

A

So you can, you can take that definition of the contract and then you can generate code for any language both for the server and the client and the contract. Though there types of that.

B

A

B

Yeah and you said any language but I mean a large ecosystem. Yeah.

A

Yeah, not every language are there, but I suspect. There's.

B

A list of there, so so what we've done in net is we've actually integrated into the MS build system to give you nice core generation. So what I'm gonna do is I'm gonna jump over to my project file. Okay,.

A

B

Understand, what's going on, yes, and you will see, I have this item group with a protobuf element. Okay and I've actually included the protobuf mmm and I've also said the type of core generation I want is a server. Oh nice.

A

Can you do server and clients you.

B

A

Just another line in there: oh, it's just changing this value, but can I do that at the same time, yeah ah great I.

B

Believe it's the attribute is both ah haha there.

A

B

It's so yeah, so once you include this mm-hmm, you go ahead and build your project. Yeah.

A

B

This generated cord right, ah so, if I just real, quick, just peek into my knobs folder, you will see these files great dot, CS and 30 gr, PC darts, yes, so that contains lead. Rcs contains my generated message. Types yep, rich RPC, contains the service stubs right, great.

A

B

You were in Visual Studio. We actually integrate with design time build. So all you do is you go modify your profile, you hit, save and it generates behind the covers for you, the power.

A

Off IDs, my friend yeah.

B

Good so I've gone ahead, I mean I've already shown you this running, but let's just go over semantics. So now we author, this mm-hmm. We build the project that generates the code files, yeah.

C

B

That the thing for us to do is actually go up and implement the service. You.

C

B

I have this directory called services.

C

B

Doesn't have any special semantic, meaning it's just nice to organize my cord yep, but the generated code did generate this greeter base class great.

A

So everything derived from that database or is that knows.

B

It so I would have to implement my RPC. Oh right.

A

B

Giant so I've, obviously over it in this say hello method, mm-hmm and all I'm doing is pulling out the name from the request object. Okay,.

A

B

Returning hello space identifier.

A

Requests I can see that so and.

B

It feels familiar where they ask me not core you'll see things like you know: constructor injection, via di yeah.

C

B

It's very similar paradigm. The idea was to use concepts of the app model that already were great.

A

B

Make you immediately productive, fantastic loved it right and the other part after you have actually implement the service? Is there is no there's no magic, there's no discovery of services. We want to wire up the services that we use. Yeah.

A

B

I think I showed that before, but I'll show it right again, which is I go to endpoint routing. Yes,.

A

And I say that this service, so once you cave implementation of the service, you come here and you audit yeah after.

B

The fact so now it's running go back over here. Let me just make sure yeah, so my application is still running. Okay,.

A

B

So now we have the part where we need to actually make a call. Yes,.

A

B

This is what I alluded to earlier, that a good RPC implementation will give you very much like local calling semantics yep, even though I'm going across the network sure. So if I go look at my client- and this is my client application. Mr.

A

Shepherd application get.

B

Your own just a call, so we should see some familiar elements. Okay, you just hide this for a second, so let's go to our project file. You see again. We have some packages required for the proto buff stuff yep. We also have this like include, and if you see I've actually pointed to the same proto file. Yes,.

C

B

A source of truth and I want to generate client good, and if we go real, quick peek into my opted for mm-hm, you can see the same thing. I have the message types and then I have the client, so all make sense. Now now it's pretty much new up the client proxy or can make a call. So the first thing we do is we create a channel channel is the underlying connection. Okay,.

A

B

A Doody server that actually hosts a service okay and for the channel. We have the study, helper method that takes the address mm-hmm, so I'm, pointing in that local host five: zero, zero, five one. Yes, what my service is running, that's great and now once I have a channel I can new up a client tell decline, hey make it like. This is the underlying channel that you'll use directly then now this hello request is a generated type. Remember. This comes from our IDL file. Yes,.

C

B

Knew it up I'll just put my name in nothing, fancy and then the actual calling is as simple as I just called client say: hello, async, perfect.

A

B

Now, if I go ahead and show you the guess the moment of truth, yes,.

C

A

Ahead and run this.

B

You should see the.

A

Request comes Jamie, yeah.

B

Server side and there's appliance.

A

Id, that's brilliant I mean it's simple, but I can I can imagine the underlying. Therefore, it's been significant about it's great to see that in action right now, I have two questions: when should I use G RPC over their traditional HTTP kind of a client where I write with dot Nicole so.

B

There are, there are few advantages to using a PC. Okay, it uses. Http two is the family Magnus, which means you get connection multiplexing. You can have multiple requests over the same connection: okay, as well as it uses protobuf, it's a binary, serialization format. Okay, so you it's more compact over the wire more.

A

Efficient than there yeah it's more efficient.

B

So it might make sense if you'd like from a mobile device, something you want to talk. The other thing is the the quality I would say of generated cord is, at least in my opinion, is better than what we get for generated, HTTP clients right. So if you want, if you're in a polyglot environment, you have multiple languages, yeah.

A

B

Pc might be a, it might be a great leveler, because you know you got a quality ecosystem, no matter what language runtime you.

A

I understood I guess we have the expected kind of performance across multiple clients, multiple.

B

Implementations, okay and and and your PC support streaming right.

A

B

That's not possible with traditional API yeah.

A

B

To that point, like one of the other things that I would want to doubt that at least I personally enjoy okay, that, it seems like rest seems to be a like a dogmatic fight. Maybe ask people what is it as your PC? You could call it a strength or a weakness, but is opinionated? Okay, you can see I made a call, even though it's based on HTTP, but I never specified what the path is. What the verb used is. All of that was covered by your PC.

B

For me exactly so it's it might be easier to get started. Okay and if you aren't sure you don't have to commit to using jira PC Web API, okay, as I showed in the ad model, it's very amenable to asp net core. You can wrap your business logic and you can expose both the G RPC endpoint as well in it as an HTTP endpoint. That's.

A

Great right, so you don't have to choose one or the other can do either/or and that's great. So how do I get started a do? You have a couple of yeah, absolutely it's the links.

B

For us, this is the asp net ducks page great.

A

B

See there's a section: remote procedure calls it's a top level. Northern the documentation, yeah I can see that it's highly recommend. This is a great place to get started. Okay,.

A

B

Also have in under the tutorials node you'll see we have one further more procedure called apps awesome.

A

And I think there'll be more content coming and they're coming days or weeks. So we'll include everything in the description below on the video, so you can actually go and deep dive into G RPC and see how you can start implementing thing well, Rob. Thank you very much. Today it's been fantastic having you here and it's a great to learn about G, RPC and how to get started. It's.

B

Been my pleasure thank.

A

A