mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-12-17 20:41:49 +03:00
52 lines
1.9 KiB
ReStructuredText
52 lines
1.9 KiB
ReStructuredText
Using an existing Heroku database
|
|
=================================
|
|
|
|
.. contents:: Table of contents
|
|
:backlinks: none
|
|
:depth: 1
|
|
:local:
|
|
|
|
Let's say you have an existing `Heroku Postgres <https://www.heroku.com/postgres>`_ database with data in it, and you'd
|
|
like add GraphQL on it.
|
|
|
|
.. note::
|
|
|
|
In case you're exposing an existing database (esp. if it is production), please configure an access key
|
|
for the console and the GraphQL endpoint.
|
|
|
|
Step 0: Deploy Hasura on Heroku
|
|
-------------------------------
|
|
|
|
Deploy Hasura on Heroku by clicking on this button:
|
|
|
|
.. image:: https://camo.githubusercontent.com/83b0e95b38892b49184e07ad572c94c8038323fb/68747470733a2f2f7777772e6865726f6b7563646e2e636f6d2f6465706c6f792f627574746f6e2e737667
|
|
:width: 200px
|
|
:alt: heroku_deploy_button
|
|
:class: no-shadow
|
|
:target: https://heroku.com/deploy?template=https://github.com/hasura/graphql-engine-heroku
|
|
|
|
Follow the Heroku instructions to deploy, check if the Hasura console loads up when you **View app** and then head
|
|
to the **Manage App** screen on your Heroku dashboard.
|
|
|
|
Step 1: Remove the existing Postgres addon in the app
|
|
-----------------------------------------------------
|
|
|
|
Head to your Heroku dashboard and delete the Postgres addon:
|
|
|
|
.. image:: ../../../../img/graphql/manual/deployment/remove-heroku-postgres-addon.png
|
|
|
|
Step 2: Configure environment variables
|
|
---------------------------------------
|
|
|
|
Now configure the ``DATABASE_URL`` with your existing Heroku Postgres database URL and a ``HASURA_GRAPHQL_ACCESS_KEY``
|
|
if you want to secure your endpoint.
|
|
|
|
.. image:: ../../../../img/graphql/manual/deployment/heroku-database-url-access.png
|
|
|
|
Step 3: Track tables and relationships
|
|
--------------------------------------
|
|
|
|
Wait for the GraphQL engine to restart and you'll see your existing tables as "untracked tables" in the console.
|
|
|
|
.. image:: ../../../../img/graphql/manual/getting-started/TrackTable.jpg
|