Updating Hasura GraphQL engine on Heroku¶
Table of contents
This guide will help you update the Hasura GraphQL engine running on Heroku. This guide assumes that you already have a Hasura GraphQL engine running on Heroku.
The current latest version is:
hasura/graphql-engine:latestFollow these steps to update Hasura GraphQL engine to the lastest version:
Step 1: Clone the Hasura GraphQL engine Heroku app¶
The Hasura app with Heroku buildpack/configuration is available at: https://github.com/hasura/graphql-engine-heroku.
Clone the above repository.
git clone https://github.com/hasura/graphql-engine-heroku
cd graphql-engine-heroku
If you already have this, then pull the latest changes which will have the updated GraphQL engine Docker image.
Step 2: Attach your Heroku app¶
Let’s say your Heroku app is called hasura-heroku and is running on https://hasura-heroku.herokuapp.com.
Navigate to your project directory, use the Heroku CLI to configure the git repo you cloned in Step 1 to be able to push to this app.
# Replace <hasura-heroku> with your Heroku app's name
heroku git:remote -a <hasura-heroku>
heroku stack:set container -a <hasura-heroku>
You can find your Heroku git repo in your Heroku - Settings - Info - Heroku Git URL
Step 3: git push to deploy the latest Hasura GraphQL engine¶
When you git push to deploy, the Heroku app will get updated with the latest changes:
git push heroku master
Deploy a specific version of the Hasura GraphQL engine¶
Head to the Dockerfile in the git repo you cloned in step 1.
Change the FROM line to the specific version you want. A list of all releases can be found
at https://github.com/hasura/graphql-engine/releases.
FROM hasura/graphql-engine:v1.0.0
...
...
Change v1.0.0 to v1.1.0 for example, commit this and then git push heroku master to deploy.
Note
If you are downgrading to an older version of the GraphQL engine you might need to downgrade your metadata catalogue version as described in Downgrading Hasura GraphQL engine
