Manually moving Hasura Cloud v1.3 projects to Hasura v2.0¶
Table of contents
Introduction¶
Hasura Cloud now creates new projects with Hasura v2.0 by default. Due to
some underlying architectural changes in v2.0, existing projects have not
yet been upgraded to v2.0. This upgrade will be done automatically in the
very near future.
In the meanwhile it is possible to manually “move” your project to use Hasura
v2.0.
Do check the changelog first to see what changes and features have been introduced.
Move existing v1.3 project to a v2.0 project¶
As it is not possible to actually upgrade your v1.3 project to v2.0, you will have to
essentially create a new Hasura project with v2.0 and connect it with your database with the same
Hasura metadata as in the previous project.
Step 1: Export metadata from existing project¶
See exporting metadata to get a copy of the current Hasura metadata on your project.
Do ensure no further changes are made to the Hasura metadata post this.
Step 2: Create a v2.0 Cloud project¶
See Step 1 of creating projects to create a new Hasura Cloud v2.0
project.
Step 3: Connect your database with the name default to the new project¶
See Step 2 of creating projects to connect your existing database to
the new project. Please ensure you set the database name as default.
Note
After connecting a database to a v2.0 project it will not be usable with
a v1.3 project. Hence it is recommended to stop your v1.3 project
before doing this.
Step 4: Apply the exported metadata to the new project¶
See applying metadata to apply the earlier exported metadata to the new project.
Your GraphQL API should now be regenerated as in the earlier v1.3 project.
Thank you for subscribing to our newsletter!
