Конечная точка Hasura GraphQL за шлюзом Apollo Federated Gateway

Можно смонтировать Hasura через apollo-gateway [1], используя простой обходной путь. Основным требованием является наличие поля с именем _service в вашей схеме graphql [2]. Поле _service - это не что иное, как схема Хасуры в формате Schema Definition Language (SDL).

Вы можете добавить это поле к вашему типу query с помощью удаленной схемы [3]. Вот пример удаленной схемы:

const { ApolloServer } = require('apollo-server');
const gql = require('graphql-tag');
const hasuraSchema = require('./schema.js');

const typeDefs = gql`

  schema {
    query: query_root
  }

  type _Service {
    sdl: String
  }

  type query_root {
    _service: _Service!
  }

`;

const resolvers = {
    query_root: {
        _service: () =>  { return {sdl: hasuraSchema} },
    },
};

const schema = new ApolloServer({ typeDefs, resolvers });

schema.listen({ port: process.env.PORT}).then(({ url }) => {
    console.log(`schema ready at ${url}`);
});

Ключевым значением здесь является const hasuraSchema, который представляет собой схему Hasura в формате SDL, т.е.

// schema.js

const hasuraSchema = `

# NOTE: does not have subscription field
schema {
  query: query_root
  mutation: mutation_root
}

type articles {
  id: Int!
  title: String!
}

type query_root {
 ...
}

type mutation_root {
 ...
}
`

module.exports = hasuraSchema;

Вы можете получить SDL схемы Hasura автоматически с помощью многих инструментов сообщества, включая graphql-js [4] или graphqurl [5].

Полностью автоматизированный пример размещен здесь: https://gist.github.com/tirumaraiselvan/65c6fa80542994eda6ad06 >

1. Это позволяет обслуживать Hasura только через apollo-gateway и не означает, что это включает возможности федерации.
2. https://www.apollographql.com/docs/apollo-server/federation/federation-spec/#fetch-service-capabilities
3. https://docs.hasura.io/1.0/graphql/manual/remote-schemas/index.html
4. https://graphql.org/graphql-js/utilities/#printintrospectionschema
5. https://github.com/hasura/graphqurl#export-schema
6. https://github.com/apollographql/apollo-server/issues/2360#issuecomment-531849628