server-cloud/

README

server-cloud

This directory contains the control-plane backend server for cloud deployments.

Running in development

1. Create a .env file at the root of the repo containing:

RILL_CLOUD_ENV=development
RILL_CLOUD_DATABASE_DRIVER=postgres
RILL_CLOUD_DATABASE_URL=postgres://postgres:postgres@localhost:5432/postgres
RILL_CLOUD_PORT=8080
RILL_CLOUD_SESSIONS_SECRET=secret
RILL_CLOUD_AUTH_DOMAIN=gorillio-stage.auth0.com
RILL_CLOUD_AUTH_CALLBACK_URL=http://localhost:8080/auth/callback
# Get these from https://auth0.com/ (or ask a colleague)
RILL_CLOUD_AUTH_CLIENT_ID=
RILL_CLOUD_AUTH_CLIENT_SECRET=

1. In a separate terminal, run Postgres in the background:

docker-compose -f server-cloud/docker-compose.yml up 

1. Run the server:

go run server-cloud/cmd/main.go

Adding endpoints

We define endpoints using OpenAPI and generate Go handlers and types using oapi-codegen. To add a new endpoint:

1. Describe the new endpoint in server-cloud/api/openapi.yaml
2. Make sure you have oapi-codegen installed by running go mod tidy
3. Run: go generate ./server-cloud/api
4. Copy the new handler(s) from server-cloud/api/server.gen.go into server-cloud/server/handlers.go and implement it