Building scalable solutions with Apollo Federation and Fauna

Please be advised that Fauna GraphQL currently does not support the subgraph specification of Apollo Federation 2.0.

If you are looking to integrate all the Federation subgraph specs we recommend you use Fauna with a Subgraph Compatible App server. As Fauna is a general purpose database you can use it with any backend server or serverless functions to implement Federation.

Challenges of modern application development and how to solve it

Application architecture

Microservices and Fauna (Traditional subgraphs)

Using Fauna-hosted GraphQL endpoints as subgraphs

Hybrid model

Getting started with Fauna and Apollo Federation 2

Configure Fauna

type Shop {
  name: String!
  description: String!
  coverImg: String!
  products: [Product]! @relation
  ownerID: String!
}

type Product {
  name: String!
  description: String!
  price: Float!
  category: String!
  imageUrl: String
  shop: Shop! @relation
}

type Query {
  products: [Product]
}

Add Records to Your Collection

mutation CreateProduct {
  createProduct(
   data: {
    name: "fender stratocaster",
    description: "The world's greatest electric guitar",
    price: 1255,
    imageUrl: "guitar.png",
    category: "Music",
  }
 ) {
   _id
   name
 }
}

mutation CreateShop {
  createShop(
   data: {
    ownerID: "1223302094",
    name: "Scarborough Music and Records",
    description: "some music shop",
    coverImg: "example-shop.png"
   }
  ) { _id }
}

Integrate Fauna and Apollo

Setting up supergraph

federation_version: 2
subgraphs:
  fauna:
   routing_url: https://graphql.fauna.com/graphql`
   schema:
     file: ./fauna.graphql
 locations:
   routing_url: https://flyby-locations-sub.herokuapp.com/
   schema:
     subgraph_url: https://flyby-locations-sub.herokuapp.com/

$ rover supergraph compose --config ./supergraph-config.yaml > supergraph.graphql

Local composition service with Apollo Gateway and Federation

const { ApolloServer } = require('apollo-server');
const { ApolloGateway, RemoteGraphQLDataSource } = require('@apollo/gateway');
const { readFileSync } = require('fs');

const supergraphSdl = readFileSync('./supergraph.graphql').toString();

class AuthenticatedDataSource extends RemoteGraphQLDataSource {
  willSendRequest({ request, context }) {
    request.http.headers.set('Authorization', context.token);
  }
}

const gateway = new ApolloGateway({
  supergraphSdl,
  buildService({ name, url }) {
    return new AuthenticatedDataSource({ url });
  },
});

const server = new ApolloServer({
  gateway,
  subscriptions: false,
  context: ({ req }) => {
    const token = req.headers.authorization || '';
    return { token };
  },
});

server.listen().then(({ url }) => {
  console.log(`🚀 Gateway ready at ${url}`);
}).catch(err => {console.error(err)});

npm i apollo-server @apollo/gateway --save

Query your federated subgraph

query FindProductByID($findProductByIdId: ID!) {
  findProductByID(id: $findProductByIdId) {
    _id
    name
    description
  }
  locations {
    id
    name
  }
 }

Conclusion