• Installation
  • Required software
• Usage
  • Start hasura
  • Commands
• Useful links

The following instructions will walk you through the process of setting up and deploying project on your local machine.

• Hasura cli
• Docker and Docker Compose (*optional)

All hasura data are located at hasura folder, local docker-compose located this or this for Mac-m1.

First you must start hasura and pg by make up (or make up-m1). This command will run hasura in host network mode and postgres, which will be available at localhost:5439.

Once you've done that, update hasura state via:

• make hasura-update

After that hasura will be available at localhost:8080.

This section will show main make commands. For a full command list you can use make help.

• Hasura docs

make migration-create name=migration_name

Создаются файлы up/down в директории hasura/migrations/default/

Пишем миграции только руками, не пользуемся встроенными генераторами миграций в hasura console - с ней могут быть проблемы, она не может корректно перекидывать индексы, строить down миграции и прочее.

Не забываем про экспорт мета-данных, которые необходимы для мапинга таблиц в hasura. На нужные таблицы добавляем необходимые права доступа для user/anonymous на insert/select/update/delete. Далее экспортируем мета-данные командой:

make metadata-export

Полученные sql и yaml отгружаем в репозиторий.