Skip to content

Commit 5f1b1b2

Browse files
authored
supercharge subgraph blog (#1781)
* supercharge subgraph blog * fix typo * adjust heading size * make it work * updates * run prettier * fix lint * update image * update thunmbnail * prettier * feedback
1 parent 866cd05 commit 5f1b1b2

File tree

5 files changed

+135
-1
lines changed

5 files changed

+135
-1
lines changed

packages/website-router/src/config.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ export const jsonConfig = {
9898
},
9999
'/graphql/gateway': {
100100
redirect: 'https://the-guild.dev/graphql/hive/docs/gateway',
101-
status: 302
101+
status: 302,
102102
},
103103
'/graphql/eslint': {
104104
rewrite: 'graphql-eslint.pages.dev',
79.4 KB
Loading
424 KB
Loading
Lines changed: 134 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
---
2+
title: Supercharge Your Supergraph with Hive
3+
tags: [graphql, graphql-hive]
4+
authors: saihaj
5+
date: 2024-10-30
6+
description:
7+
Explore API management for Federated GraphQL with Hive. Unlock tools for collaboration,
8+
monitoring, and governance to simplify your API architecture.
9+
thumbnail: /blog-assets/supercharge-your-subgraph-with-hive/thumbnail.png
10+
---
11+
12+
In the world of modern APIs, GraphQL has taken the spotlight for its flexibility, efficiency, and
13+
developer-centric approach to querying data. But as applications grow, so do the complexities of
14+
managing APIs across teams and services. That's where Supergraphs and federated GraphQL come into
15+
play, taking GraphQL to the next level by enabling distributed teams to collaborate effectively on a
16+
unified graph. The Hive GraphQL API platform empowers you with the tools to master the challenges of
17+
Federated GraphQL
18+
19+
In this article, we'll dive into the concept of Supergraphs with Federation and explore how Hive
20+
supercharges your supergraph with essential tools for monitoring, collaboration, and governance.
21+
22+
## What's a Supergraph?
23+
24+
A **supergraph** is a unified data graph created by combining several smaller, independently managed
25+
subgraphs. It serves as the backbone of large-scale GraphQL implementations, where different teams
26+
or microservices manage their own subgraphs but contribute to the overall system. This allows your
27+
architecture to scale while maintaining the simplicity and power of a single, unified API.
28+
29+
By federating multiple subgraphs into a supergraph, organizations can delegate responsibilities
30+
across teams while ensuring that consumers still interact with a single API. To see an example in
31+
action, check out our
32+
[documentation here](https://the-guild.dev/graphql/hive/docs/get-started/apollo-federation?utm_source=the_guild&utm_medium=blog&utm_campaign=supercharge-your-subgraph-with-hive).
33+
34+
## Understanding Apollo Federation
35+
36+
[**Apollo Federation**](https://www.apollographql.com/docs/federation/?utm_source=the_guild&utm_medium=blog&utm_campaign=supercharge-your-subgraph-with-hive)
37+
is an implementation of Subschema Directive-based
38+
[Type Merging](https://the-guild.dev/graphql/stitching/docs/approaches/type-merging?utm_source=the_guild&utm_medium=blog&utm_campaign=supercharge-your-subgraph-with-hive) that
39+
is defined by the Apollo Federation Specification. This technique allows for multiple GraphQL
40+
services to work together as a single, cohesive API. Instead of one massive schema, you have smaller
41+
schemas (aka subgraphs) that represent different parts of your system. Federation makes these
42+
subgraphs interoperable and composable, enabling teams to **independently** maintain services while
43+
contributing to the supergraph.
44+
45+
Here's a simplified view of the architecture:
46+
47+
- **Subgraphs**: Services owned by individual teams with their GraphQL schemas.
48+
- **Gateway**: A gateway that resolves queries by creating a query plan to direct them to the
49+
relevant subgraphs, unifying all subgraphs into a single supergraph.
50+
51+
This decoupled structure improves **scalability**, allows for
52+
[microservice-like architecture](https://microservices.io/patterns/microservices.html?utm_source=the_guild&utm_medium=blog&utm_campaign=supercharge-your-subgraph-with-hive),
53+
and enables more agile teams.
54+
55+
![architecture](./architecture.png)
56+
57+
## Challenges of Managing a Supergraph
58+
59+
Although a supergraph provides scalability and flexibility, its management involves several
60+
complexities:
61+
62+
- **Version Control and Schema Evolution**: Modifications in a single subgraph can ripple through
63+
the entire supergraph, affecting its overall functionality.
64+
- **Performance Tracking and Optimization**: With the integration of numerous services, monitoring
65+
and maintaining performance across the whole API becomes increasingly complex.
66+
- **Coordination and Oversight**: With multiple teams working on the same supergraph, ensuring
67+
consistency and effective governance becomes crucial yet challenging.
68+
69+
## Enters Hive
70+
71+
**GraphQL Hive (Hive)** is a powerful, open source solution designed to address the challenges of
72+
managing a supergraph. It's a GraphQL API management platform that provides observability, schema
73+
registry, and collaboration tools to keep your supergraph organized and performant.
74+
75+
## Key Features of Hive
76+
77+
- **Schema Registry** Simplify schema publishing, federated service composition, and detecting
78+
breaking changes.
79+
- **Composition Error Prevention:** Avoid runtime errors by validating integrity of all your
80+
subgraph schemas.
81+
- **Schema Explorer:** Navigate through your schema and check ownership and usage of types.
82+
- **Version Control System:** Track schema modifications across multiple environments from
83+
development to production.
84+
- **Schema Checks:** Identify any breaking changes before they reach production. Evolve your
85+
schema with confidence.
86+
- **Observability** Advanced tools to gain deep insights into API performance and user experience.
87+
- **GraphQL consumers:** Track GraphQL requests to see how schema is utilized and by what
88+
applications.
89+
- **Overall performance:** Track and analyze overall GraphQL API performance.
90+
- **Query performance:** Pinpoint slow operations to identify performance bottlenecks.
91+
- **Schema Management** Evolve your GraphQL API with confidence.
92+
- **Prevent breaking changes:** Integrated Schema Registry with GraphQL Monitoring for confident
93+
API evolution.
94+
- **Schema Policy:** Lint, verify, and enforce best practices across your federated GraphQL
95+
architecture.
96+
- **Detect unused fields:** Detect unused fields in your GraphQL schema for efficiency and
97+
tidiness.
98+
- **Security** Safeguard your GraphQL API through secure deployment practices.
99+
- **Persisted operations**: pre-register GraphQL operations that will be executed against the
100+
GraphQL API
101+
102+
## Why Choose Hive for Your Supergraph?
103+
104+
GraphQL Hive offers the **observability, control, and collaboration** tools you need to run a
105+
successful supergraph architecture. While Hive works seamlessly with **any** Apollo Federation
106+
gateway, we also offer
107+
[Hive Gateway](https://the-guild.dev/graphql/hive/docs/gateway?utm_source=the_guild&utm_medium=blog&utm_campaign=supercharge-your-subgraph-with-hive),
108+
the
109+
[only 100% Apollo Federation-compatible gateway solution](https://the-guild.dev/blog/federation-gateway-audit?utm_source=the_guild&utm_medium=blog&utm_campaign=supercharge-your-subgraph-with-hive).
110+
Here's why Hive stands out:
111+
112+
- **Enhanced Developer Experience**: Developers can focus on building features instead of worrying
113+
about schema conflicts, performance issues, or breaking changes.
114+
- **Streamlined Operations**: Hive’s monitoring and validation tools reduce the operational burden
115+
of maintaining a supergraph.
116+
- **Governance**: Hive enables you to enforce schema policies, ensuring best practices and
117+
consistency across all subgraphs. This governance framework helps maintain a unified and
118+
high-quality API.
119+
- **Enterprise-Grade Features**: Enjoy free Single Sign-On (SSO) for secure and seamless access
120+
management, along with advanced collaboration tools designed to meet the needs of large teams.
121+
122+
![features](./features.png)
123+
124+
## Conclusion
125+
126+
Apollo Federation transformed how we scale GraphQL across large teams and distributed services. Now,
127+
GraphQL Hive takes it even further by offering powerful tools to manage, monitor, and optimize your
128+
supergraph. With Hive, you can confidently build, deploy, and maintain a high-performing, scalable,
129+
and collaborative GraphQL architecture.
130+
131+
**Ready to enhance your API management?** Get started by
132+
[setting up your federated GraphQL services on GraphQL Hive](https://the-guild.dev/graphql/hive/docs/get-started/apollo-federation?utm_source=the_guild&utm_medium=blog&utm_campaign=supercharge-your-subgraph-with-hive)
133+
today and take the first step toward a more efficient, scalable, and collaborative GraphQL
134+
ecosystem.
352 KB
Loading

0 commit comments

Comments
 (0)