Pular para o conteúdo principal

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óprio Hasura, 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 o Hasura consegue gerar a API GraphQL
  • migrations: Configurações necessárias para configurar o banco, nesse caso Postgres. Geralmente são arquivos up/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.

Img

Cuidado

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.