Managing development environments with Hasura Cloud¶

Step 1: Setup local development of Hasura with Docker¶

Follow the guide here to get up and running with Hasura GraphQL engine and Postgres as Docker containers in your local system. Make sure that the ENV variable for database connection in your local setup is same as that in your Cloud project. Also add any other ENV variables that you might have set on the Cloud project.

Step 2: Install Hasura CLI¶

Follow the instructions in Installing the Hasura CLI

Step 3: Initialize a Hasura CLI project locally¶

hasura init <project-name>

Step 4: Initialize the migration files¶

This will get your database schema from the cloud project to your local setup

hasura migrate create init --from-server --endpoint <hasura-cloud-project-url> --admin-secret <admin-secret> --database-name <database-name>

# note down the version

# mark the migration as applied on the cloud project

hasura migrate apply --endpoint <hasura-cloud-project-url> --admin-secret <admin-secret> --version <version-number> --skip-execution

It is important to mark the migration as applied on the Cloud project to ensure that the schema that is already created on Hasura Cloud project is not attempted to be recreated again, which would end in an error state.

Step 5: Export metadata¶

hasura metadata export --endpoint <hasura-project-url> --admin-secret <admin-secret>

We have successfully synced our state from Cloud to the Hasura CLI local dev environment.

Next, we apply all these changes to our local Hasura with Docker setup.

Step 6: Apply metadata and migrations to your local Hasura instance¶

hasura metadata apply
hasura migrate apply --all-databases
hasura metadata reload

By default the metadata and migrations are applied to http://localhost:8080 which is the endpoint specified in the config.yaml file of your CLI project. If you want to apply the metadata and migrations to any other endpoint, you could go ahead and change the endpoint in the config.yaml file or use the --endpoint flag along with the commands above.

And you’re all set now! Go ahead and setup version control for your project for further ease of integration.

Setting up a Git repo for your Hasura project¶

In order to easily apply your local changes to your new Cloud project, we’ll use the Hasura GitHub deployment feature. But before we do that, we need to setup metadata & migrations of your local setup that you can apply to your Cloud project. For a lowdown on Hasura metadata & migrations refer the guide here

Step 1: Install Hasura CLI¶

Follow the instructions in Installing the Hasura CLI

Step 2: Setup a project directory¶

hasura init <project-name> --endpoint <local-project-endpoint>

Your local project endpoint might be http://localhost:8080 (based on how it was setup initially). This creates a project directory with migrations and metadata directories and a config.yaml file.

Step 3: Initialize the migration files¶

This will get your database schema from your local setup into the project folder.

hasura migrate create init --from-server --admin-secret <admin-secret> --database-name <database-name>

# note down the version

# mark the migration as already applied on the local server

hasura migrate apply --admin-secret <admin-secret> --version <version-number> --skip-execution

Step 4: Initialize Hasura metadata¶

hasura metadata export

This command will export the current Hasura metadata as a bunch of YAML files in the metadata directory.

Step 5: Setup version control & Git Deploy¶

# in the project directory

git init
git add .
git commit -m "initialize metadata and migrations"

Push these changes to GitHub repo of your choice.

Now we’re all set to see the magic of our GitHub integration to deploy the metadata and migrations to your Cloud project by following the steps here!