GridTime Server

Generates zoombie tile feeds, and aggregate tile feeds from flow source data streams

IDE Setup

Application stack is Gradle and Springboot. To setup the project in Intellij, first run:

./gradlew idea

Then open the generated Intellij project file in your IDE.

Setup Docker

You'll need to have Docker running to boot app the app, which spins up a postgres instance on docker. You can download here: https://docs.docker.com/docker-for-mac/install/

Type docker ps to confirm docker is running and available in the path.

Running the App

To bootup the application locally, you need to first have docker machine running. You can launch the server with:

./gradlew bootRun

Postgres Refresh

To completely refresh your postgres Database instances, you can run:

./gradlew refreshP (shorthand for target refreshPostgres)

./gradlew createTDB (shorthand for target createTestDB)

Swagger

For the Swagger UI, navigate to /swagger.html on the running server (e.g. for localhost, http://localhost:8080/swagger.html) To retrieve the swagger json, navigate to /v2/api-docs

Heroku

This application is currently deployed on Heroku at http://ds-gridtime.herokuapp.com. For an API-Key on the shared service, please contact [email protected]. We will have account creation setup soon, but while this project is still in early development, accounts are created manually.

Install heroku cli (google)

Log into heroku

heroku login

Initial Heroku Application Creation (Shouldn't need to do again)

Create the heroku application

heroku create ds-gridtime

Create the database (can upgrade to hobby-basic just by associating credit card w/ account)

heroku addons:create heroku-postgresql:hobby-dev

Configure the domain

heroku domains:add gridtime.dreamscale.io

Set up SSL

heroku certs:auto:enable

Ongoing Heroku Application Deployment

If you have not previously deployed to Heroku, initialize the remote

heroku git:remote -a ds-gridtime

Deploy the application on heroku

git push heroku master

If the server crashes:

heroku restart

If you need to access the server's database:

heroku psql

To tail the server logs:

heroku logs --tail

How to Troubleshooting Heroku DB specific Issue

heroku pg:backups:capture

heroku pg:backups:download

pg_restore --verbose --clean --no-acl --no-owner -h local.docker -U postgres -d gridtime latest.dump