Search
ctrl/
Ask AI
Light
Dark
System

Deploying EdgeDB to Google Cloud

In this guide we show how to deploy EdgeDB on GCP using Cloud SQL and Kubernetes.

Make sure you are logged into Google Cloud.

Copy
$ 
gcloud init

Set the PROJECT environment variable to the project name you’d like to use. Google Cloud only allow letters, numbers, and hyphens.

Copy
$ 
PROJECT=edgedb

Then create a project with this name. Skip this step if your project already exists.

Copy
$ 
gcloud projects create $PROJECT

Then enable the requisite APIs.

Copy
$ 
  
  
  
  
gcloud services enable \
  container.googleapis.com \
  sqladmin.googleapis.com \
  iam.googleapis.com \
  --project=$PROJECT

Use the read command to securely assign a value to the PASSWORD environment variable.

Copy
$ 
echo -n "> " && read -s PASSWORD

Then create a Cloud SQL instance and set the password.

Copy
$ 
  
  
  
  
  
gcloud sql instances create ${PROJECT}-postgres \
  --database-version=POSTGRES_14 \
  --cpu=1 \
  --memory=3840MiB \
  --region=us-west2 \
  --project=$PROJECT
Copy
$ 
  
  
  
gcloud sql users set-password postgres \
  --instance=${PROJECT}-postgres \
  --password=$PASSWORD \
  --project=$PROJECT

Create an empty Kubernetes cluster inside your project.

Copy
$ 
  
  
  
gcloud container clusters create ${PROJECT}-k8s \
  --zone=us-west2-a \
  --num-nodes=1 \
  --project=$PROJECT

Create a new service account, configure its permissions, and generate a credentials.json file.

Copy
$ 
  
gcloud iam service-accounts create ${PROJECT}-account \
  --project=$PROJECT
Copy
$ 
MEMBER="${PROJECT}-account@${PROJECT}.iam.gserviceaccount.com"
Copy
$ 
  
  
  
gcloud projects add-iam-policy-binding $PROJECT \
  --member=serviceAccount:${MEMBER} \
  --role=roles/cloudsql.admin \
  --project=$PROJECT
Copy
$ 
  
gcloud iam service-accounts keys create credentials.json \
  --iam-account=${MEMBER}

Then use this credentials.json to authenticate the Kubernetes CLI tool kubectl.

Copy
$ 
  
kubectl create secret generic cloudsql-instance-credentials \
  --from-file=credentials.json=credentials.json
Copy
$ 
  
  
  
INSTANCE_CONNECTION_NAME=$(
  gcloud sql instances describe ${PROJECT}-postgres \
      --format="value(connectionName)" \
      --project=$PROJECT
)
Copy
$ 
DSN="postgresql://postgres:${PASSWORD}@127.0.0.1:5432"
Copy
$ 
  
  
  
kubectl create secret generic cloudsql-db-credentials \
  --from-literal=dsn=$DSN \
  --from-literal=password=$PASSWORD \
  --from-literal=instance=${INSTANCE_CONNECTION_NAME}=tcp:5432

Download the starter EdgeDB Kubernetes configuration file. This file specifies a persistent volume, a container running a Cloud SQL authorization proxy, and a container to run EdgeDB itself. It relies on the secrets we declared in the previous step.

Copy
$ 
wget "https://raw.githubusercontent.com\
/edgedb/edgedb-deploy/dev/gcp/deployment.yaml"
Copy
$ 
kubectl apply -f deployment.yaml

Ensure the pods are running.

Copy
$ 
kubectl get pods
NAME                     READY   STATUS              RESTARTS   AGE
edgedb-977b8fdf6-jswlw   0/2     ContainerCreating   0          16s

The READY 0/2 tells us neither of the two pods have finished booting. Re-run the command until 2/2 pods are READY.

If there were errors you can check EdgeDB’s logs with:

Copy
$ 
kubectl logs deployment/edgedb --container edgedb

Now that our EdgeDB instance is up and running, we need to download a local copy of its self-signed TLS certificate (which it generated on startup) and pass it as a secret into Kubernetes. Then we’ll redeploy the pods.

Copy
$ 
  
  
  
  
  
  
  
  
kubectl create secret generic cloudsql-tls-credentials \
  --from-literal=tlskey="$(
      kubectl exec deploy/edgedb -c=edgedb -- \
          edgedb-show-secrets.sh --format=raw EDGEDB_SERVER_TLS_KEY
  )" \
  --from-literal=tlscert="$(
      kubectl exec deploy/edgedb -c=edgedb -- \
          edgedb-show-secrets.sh --format=raw EDGEDB_SERVER_TLS_CERT
  )"
Copy
$ 
kubectl delete -f deployment.yaml
Copy
$ 
kubectl apply -f deployment.yaml
Copy
$ 
kubectl expose deploy/edgedb --type LoadBalancer

Get the public-facing IP address of your database.

Copy
$ 
kubectl get service
NAME         TYPE           CLUSTER-IP  EXTERNAL-IP   PORT(S)
edgedb       LoadBalancer   <ip>        <ip>          5656:30841/TCP

Copy and paste the EXTERNAL-IP associated with the service named edgedb. With this IP address, you can construct your instance’s DSN:

Copy
$ 
EDGEDB_IP=<copy IP address here>
Copy
$ 
EDGEDB_DSN="edgedb://edgedb:${PASSWORD}@${EDGEDB_IP}"

To print the final DSN, you can echo it. Note that you should only run this command on a computer you trust, like a personal laptop or sandboxed environment.

Copy
$ 
echo $EDGEDB_DSN

The resuling DSN can be used to connect to your instance. To test it, try opening a REPL:

Copy
$ 
edgedb --dsn $EDGEDB_DSN --tls-security insecure
EdgeDB 3.x (repl 3.x)
Type \help for help, \quit to quit.
edgedb> select "hello world!";

To make this instance easier to work with during local development, create an alias using edgedb instance link.

The command groups edgedb instance and edgedb project are not intended to manage production instances.

Copy
$ 
  
  
  
  
  
echo $PASSWORD | edgedb instance link \
  --dsn $EDGEDB_DSN \
  --password-from-stdin \
  --non-interactive \
  --trust-tls-cert \
  gcp_instance

You can now refer to the remote instance using the alias instance on your machine called gcp_instance. You can use this alias wherever an instance name is expected; for instance, you can open a REPL:

Copy
$ 
edgedb -I gcp_instance

Or apply migrations:

Copy
$ 
edgedb -I gcp_instance migrate

To connect to this instance in production, set the EDGEDB_DSN environment variable wherever you deploy your application server; EdgeDB’s client libraries read the value of this variable to know how to connect to your instance.

Using an HTTP client, you can perform health checks to monitor the status of your EdgeDB instance. Learn how to use them with our health checks guide.