History

Edvard 9b986c4c14 Nuke OpenRC from docker image, update readme's		2019-02-11 11:27:33 +01:00
..
spec	enable CORS	2018-11-13 14:29:08 -06:00
src	Dockerize postgraphile	2019-02-11 11:27:27 +01:00
.dockerignore	Dockerize postgraphile	2019-02-11 11:27:27 +01:00
Dockerfile	Nuke OpenRC from docker image, update readme's	2019-02-11 11:27:33 +01:00
package.json	Dockerize postgraphile	2019-02-11 11:27:27 +01:00
README.md	Nuke OpenRC from docker image, update readme's	2019-02-11 11:27:33 +01:00
tsconfig.json	Add Postgraphile subscription exposure	2018-09-04 20:20:43 -05:00
tsconfig.test.json	Add Postgraphile subscription exposure	2018-09-04 20:20:43 -05:00
tslint.json	Add Postgraphile subscription exposure	2018-09-04 20:20:43 -05:00
webpack.config.js	Add Postgraphile subscription exposure	2018-09-04 20:20:43 -05:00
yarn.lock	Dockerize postgraphile	2019-02-11 11:27:27 +01:00

README.md

Vulcanize GraphQL API

This application utilizes Postgraphile to expose GraphQL endpoints for exposure of the varied data that VulcanizeDB tracks.

Docker use

Note: currently this image is ~500MB large (unpacked)

Build the docker image in this directory. Start the GraphiQL frontend by:

Setting the env variables for the database connection: DATABASE_HOST, DATABASE_NAME, DATABASE_USER, DATABASE_PASSWORD (and optionally DATABASE_PORT if running on non-standard port).
- The specified user needs to be superuser on the vulcanizeDB database
Run the container (ex. docker run -e DATABASE_HOST=localhost -e DATABASE_NAME=vulcanize_public -e DATABASE_USER=vulcanize -e DATABASE_PASSWORD=vulcanize -d m0ar/images:postgraphile-alpine)
GraphiQL is available at :3000/graphiql

Building

This application assumes the use of the Yarn package manager. The use of npm may produce unexpected results.

Install dependencies with yarn and execute yarn build. The bundle produced by Webpack will be present in build/dist/.

This application currently uses the Postgraphile supporter plugin. This plugin is present in the vendor/ directory and is copied to node_modules/ after installation of packages. It is a fresh checkout of the plugin as of August 31st, 2018.

Running

Provide the built bundle to node as a runnable script: node ./build/dist/vulcanize-postgraphile-server.js

Testing

Tests are executed via Jasmine with a console reporter via the yarn test task.