https://github.com/tk42/bbff
the best backend for frontend with graphql (Hasura) and sqlc
https://github.com/tk42/bbff
graphql hasura sqlc
Last synced: about 1 year ago
JSON representation
the best backend for frontend with graphql (Hasura) and sqlc
- Host: GitHub
- URL: https://github.com/tk42/bbff
- Owner: tk42
- License: mit
- Created: 2022-12-11T01:34:23.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-02-08T11:46:32.000Z (about 3 years ago)
- Last Synced: 2025-01-04T04:14:42.766Z (about 1 year ago)
- Topics: graphql, hasura, sqlc
- Homepage:
- Size: 44.9 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bbff
the best backend for frontend
## Quickstart
For migration
```
docker compose -f docker-compose.autogen.yml up
```
For demo
```
docker compose up
```
and in Hasura UI push `Track All` button twice. one for tables/views and the other for foreign-keys. See more details in [here](https://hasura.io/docs/latest/schema/postgres/using-existing-database/).
## Deploy (on CloudRun)
1. Create a repository in Google Artifact (e.g. 'backend' in ap-northeast1)
2. Tag the docker image on Local PC
```
docker tag hasura/graphql-engine:v2.16.0.ubuntu.amd64 asia-northeast1-docker.pkg.dev//backend/graphql-engine
```
and configure the docker registory if you need
```
gcloud auth configure-docker asia-northeast1-docker.pkg.dev
```
3. Push the image
```
docker push asia-northeast1-docker.pkg.dev//backend/graphql-engine
```
4. Set as following based on [here](https://github.com/hasura/graphql-engine/issues/2673#issuecomment-545182529)
```
postgres://:@/?host=/cloudsql/
```
5. for migration, add a network temp as [here](https://cloud.google.com/sql/docs/postgres/configure-ip)
6. Test connection
```
psql -h -p 5432 -U -d
```
7. Appendix. After create the schema, to recreate a new schema
```
create schema public;
grant usage on schema public to public;
grant create on schema public to public;
```
## Migration
```
cd ./sqlc/schema
goose create alter_table_name sql
cd ../
docker-compose -f docker-compose.autogen.yml up
```
then edit the file in sqlc/schema/YYYYMMDD_alter_table_name.sql
See for more information [here](https://github.com/pressly/goose)
## Auto-generated Docs
[ER relationships](https://raw.githubusercontent.com/tk42/bbff/main/dbdoc/schema.svg) and [schema table](./dbdoc/README.md) are auto-generated by tbls
## Reference
- [Hasuraがめちゃくちゃ便利だよという話](https://qiita.com/maaz118/items/9e198ea91ad8fc624491)
- [Hasuraを使ってみた](https://qiita.com/kyamamoto9120/items/e0f3f15dac9ff532e202)
- [SELECT構文：JOINを使ってテーブルを結合する](https://rfs.jp/sb/sql/s03/03_3.html)