Hasura
O repositório do Hasura
está disponível em
https://github.com/ibortransporte/hs.
Abaixo está descrito a estrutura de pastas simplificada:
.
├── config.yaml Configuração de acesso ao Hasura (endpoint, admin_secret)
├── metadata Arquivos de configuração do Hasura (actions, events, relacionamentos)
├── migrations Diretório contendo as migrações de versão dos bancos
│ └── default Migrações do banco padrão do Hasura (Postgres / hdb_catalog)
└── seeds Dados padrões inseridos no banco (não utilizado)
metadata
: Configurações do próprioHasura
, as tabelas que estão "trackeadas", os relacionamentos que elas possuem, a configuração de permissões, como é feito o acesso ao banco e assim por diante. Com essas informações oHasura
consegue gerar a APIGraphQL
migrations
: Configurações necessárias para configurar o banco, nesse casoPostgres
. Geralmente são arquivosup/down.sql
que criam tabelas, indexes, stored procedures e outros no próprio banco de dados.
Como acessar o console
Para acessar o console do Hasura
primeiro faça a instalação da CLI
do
Hasura
https://hasura.io/docs/latest/hasura-cli/install-hasura-cli/.
Com a CLI
instalada rode o seguinte comando na raiz do projeto.
hasura console
Isso irá iniciar um servidor local na porta 9695
com o console do Hasura
. As
alterações feitas nesse console serão salvas nos arquivos desse projeto. O
acesso é feito utilizando o endpoint em que o Hasura
está sendo executado e o
admin secret configurado.
Por segurança o admin_secret deve ser usado apenas no backend. De
preferência apenas no Hasura
e a API Node
devem ter acesso a ele. Outras
aplicações devem utilizar de uma API key ou o token JWT já configurado para
administradores/usuários.