AntCas / nextjs-prisma-digital-ocean-app-platform

Hosted Founders' Club

This project was based on https://www.digitalocean.com/community/tutorials/how-to-build-a-graphql-api-with-prisma-and-deploy-to-digitalocean-s-app-platform#step-7-%E2%80%94-defining-the-data-model-with-prisma-migrate

The goal of this project is to provide a hosted and abstract version of the Founders' Club matching system that can be used by other organizations.

Stack

Digital Ocean Apps Docker GraphQL Node.js Postgres Prisma Typescript?

Running the project for the first time

1. Download and install Docker
2. npm install
3. Copy the prisma environment and edit it with correct information.

cp prisma/example.env prisma/.env

Get the current DATABASE_URL from another dev on the team, you need:

username, password, portnumber, database name

4. npm run start

Hidden files to be aware of

.gitignore prisma/.env

Deploy

git push origin master

Develop

npm run develop

Close the DB

docker-compose down

Close the DB and delete all data

docker-compose down -v

Migrations

Migrations are managed by Prisma and should be run everytime a change is made to the database schema.

Create Migration

npm run make-migration "migration name"

Run Migration

npm run migrate-up

Create Prisma Client

npx prisma generate

Run migration against production DB

DATABASE_URL="Get this string from the production DB" npm run prod-migrate

Deploying to Digital Ocean App Engine

1. Create new app, set build command to npm run build, deploy command as npm run start, and HTTP port to 8080
2. Add Postgres DB component
3. Generate Prisma Client

npx prisma generate

4. Apply migrations to prod db. Copy the DB connection string into this command and run:

DATABASE_URL="postgresql://db:some_password@unique_identifier.db.ondigitalocean.com:25060/db?sslmode=require" npx prisma migrate up --experimental

Common Errors

If the build fails because your droplet ran out of memory, upgrade your droplet and try again. After the first successful deploy you can downgrade your droplet. Sometimes installing node_modules and the first build are too resource intensive for the smallest Droplet.