On this page

Deploying Hive Gateway to Google Cloud Platform

Google Cloud Platform (GCP) is a suite of cloud computing services powered by Google. It is easy to use Hive Gateway with GCP.

Google Cloud Platform (GCP) is a suite of cloud computing services powered by Google. It is easy to use Hive Gateway with GCP.

Prerequisites

You will first need to install the GCP command-line tool: gcloud. You can find instructions here.

If you already have gcloud installed, make sure it is up to date with gcloud components update.

Create a new project and make sure billing is enabled.

Cloud Functions

Cloud Functions is a serverless execution environment for building and connecting cloud services. With Cloud Functions, you write simple, single-purpose functions that are attached to events, such as an HTTP request.

It is probably the most straight forward way to deploy a Hive Gateway to GCP.

Installation

npm i @google-cloud/functions-framework @graphql-hive/gateway-runtime graphql

Usage

Gateway runtime

You can create a runnable index.js script that will be executed by Google Cloud Run Function to serve requests.

See Bundling Problems for more details about how to load the supergraph and transports option.

import { createGatewayRuntime } from "@graphql-hive/gateway-runtime";
import http from "@graphql-mesh/transport-http";
import supergraph from "./supergraph.js";

export const graphql = createGatewayRuntime({
  supergraph,
  transports: {
    http, // For example, http transport is required for subgraphs using standard GraphQL over HTTP.
  },
});

You can now deploy your function with gcloud CLI:

gcloud functions deploy graphql --runtime nodejs18 --trigger-http --allow-unauthenticated

You can now test your function by using the URL found in the httpsTrigger.url property returned by the previous command or by using the gcloud CLI:

gcloud functions describe graphql

Cloud Run

Cloud Run is the Platform as a Service by Google. It is straightforward to use Hive Gateway with it.

Installation

Create a new Node project and add Hive Gateway to its dependencies.

npm i @graphql-hive/gateway graphql

Add a start script to your package.json. Cloud Run needs to know how to start your application.

{
  "name": "hive-gateway-cloud-run-guide",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "start": "hive-gateway supergraph"
  },
  "dependencies": {
    "graphql": "latest",
    "@graphql-hive/gateway": "latest"
  }
}

You can now deploy to Cloud Run. You can use all default values, except the last one, which allows unauthenticated access to your service.

gcloud run deploy --source .

You can now access your API using the URL provided by gcloud. The default GraphQL endpoint is /graphql.

If you need to use TypeScript or any other tool that requires a build phase, such as code generation, add a Dockerfile to the root of your project so that Cloud Run can build a custom image for you.