solo.io Gloo Platform, 7 Jul 2023

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: Gloo Platform - Core API Gateway: GraphQL Demo

Description

Discover the advanced support for additional API types in Gloo Platform, with a special focus on GraphQL. Unlike traditional pass-through proxies, Gloo Platform offers a unique approach by providing a fully integrated GraphQL server built in C++ and seamlessly integrated with Envoy Proxy.

Experience the power of Gloo Platform's GraphQL capabilities as we explore its features. We start with an existing REST API, a Blog service, and showcase the transformation of this API into a GraphQL API using declarative configuration. No coding is required as Gloo Platform handles the mapping and transformation automatically.

During the demonstration, we dive into the configuration, including the schema definition language (SDL) that defines the GraphQL schema. The power of Gloo Platform becomes evident when we examine the resolvers, which automatically map the existing REST API to the GraphQL schema. This transformation is encapsulated in a route table, a familiar concept within Gloo Platform.

With the configuration in place, we witness the appearance of the GraphQL API in the Gloo Platform UI. The API registry provides a comprehensive view of the schema, including queries and entities. For seamless exploration and interactive query building, we utilize GraphiQL, an intuitive tool that enables us to access and retrieve data from the GraphQL API.

But Gloo Platform doesn't stop at transforming a single API type. It offers the ability to aggregate multiple API types, such as REST and gRPC, into a unified GraphQL API. By adding an additional upstream REST API and annotating it with a resolver, we demonstrate the combination of data sources within the GraphQL server.

This demonstration merely scratches the surface of the powerful capabilities Gloo Platform offers for GraphQL. Explore the endless possibilities and unlock the potential of GraphQL in your API ecosystem with Gloo Platform.

Stay tuned for more content and innovative solutions from Gloo Platform.

A

In this section of the demo,, we're going to focus.

A

On some additional api types that gloo platform supports, starting with graphql.

A

We have a very unique approach to graphql and gloo platform in the sense that we.

A

Built a full graphql server in c++ natively integrated with envoy proxy.. It is not just.

A

A pass-through proxy for graphql requests with a little bit of extra routing.. It.

A

Is a full graphql server that supports the full scope of primitives in the graphql spec.

A

And integrates with existing grpc htp rest, and graphql apis,, including the ability to stitch.

A

And federate those graphql apis.. So let's have a quick look at how this works in gloo, platform.

A

So we're going to start out here with an existing rest api, that is a blog service,.

A

So go ahead and curl that down and you can see it's just got some basics.... It's got id, the.

A

User that entered the blog entry,, the title of the blog entry, and the content in latin of course.

A

Another unique aspect of how gloo platform supports graphql is that no coding is required...

A

It's 100% declarative configuration.. So if we go in and look at some of the configuration,, we need.

A

To turn our existing rest api into a graphql api. we're going to start off looking at the.

A

Definition of the schema,, just like with open api,, we'll have a standard spec for a graphql api and.

A

That is in schema definition, language or sdl.. This is straight up. Standard, graphql, schema definition.

A

Language,, nothing special here.... The magic comes in when we look at this resolver's definition,.

A

And what we're saying, is, "hey, there's a field in that sdl called 'get-blog', which is a query,.

A

And we're going to map that automatically to an existing rest api,, which is the one we just.

A

Curled earlier," and what gloo platform will do is it will automatically transform that existing rest.

A

Api and map the field into our sdl.. We package that up inside of a route table which we saw in.

A

Many other areas of our demo today for things like rest, apis..., we'll see it with lambdas and a bunch.

A

Of other api types within gloo platform., so let's go ahead and apply this configuration and see what.

A

Happens. I'll come over here into our terminal,, apply the config files we just discussed.. I'll.

A

Go into the gloo platform, ui... you'll notice that a new api has appeared, which is a graphql api.

A

And we go to view that api, we can see that we get a full schema view essentially like.

A

An api registry within gloo platform,, which tells us about the queries that are in that.

A

And then the entities in that sdl as well. even better within my development cycle or.

A

As a consumer, considering using this graphql api,, I can explore this api using graphical and.

A

Immediately, come in and start interactive query building to get data from this api.

A

Alright,, so we have our live access to our data now, moving from an existing rest, api getting.

A

Translated into graphql in our graphql server in envoy proxy., this mapping doesn't always have to.

A

Be one-to-one, in fact, we have a lot of customers that are aggregated either through schema, stitching.

A

Or through bringing multiple api types, whether rest or grpc, into a single, unified, graphql, api.

A

So, let's see what that looks like by adding another upstream rest api to our graph.

A

So we'll come back over into our configuration tab and notice that we can expand our schemas...

A

We'll add a user type and comments type, and these comments are actually going to.

A

Come from an additional upstream service., so you can see we have our existing blogs.

A

And then we're going to annotate that with an additional resolver, that's going to talk to.

A

Another service, which is the comment service., so if we go ahead and apply that now... now.

A

We can come back into the gloo platform ui into our interactive graphical, interface... and issue.

A

A query for the full graph that we want. That's combining multiple data sources on the back end,.

A

So we'll go ahead and run that, and we can see now it includes user details and comment as well.

A

This is really just scratching the surface of what we offer in graphql, but hopefully.

A

This is enough to give you an idea of the powerful capability inside of gloo platform.