graphile / graphile/graphile.github.io

Postgraphile Sandbox/Playground

オープン
#273 コメント 2 件 リアクション 0 件 担当者 0 名 GitHub で見る
主要言語
SCSS
スター
27
フォーク
126
PR マージ指標
30日以内にマージされた PR はありません

説明

### Feature description

Make a new repo with a [Deploy to Heroku button](https://devcenter.heroku.com/articles/heroku-button) for easily playing around with postgraphile without having to install anything or do toilsome setup.

It should come with postgres, pgadmin and postgraphile installed and running within a docker container, probably with one or more example databases installed.

It should be running with a variety of recommended plugins and settings for development, like `--enhance-graphiql` and `--allow-explain`.

By default, it should run the CLI, but it should also have a JS-driven example included with a easy switch to use that, so you can fork, write a custom plugin, and deploy with a click.

(Note that it should not use heroku's built-in postgres because it doesn't allow CREATE ROLE and could get expensive if a malicious actor spotted a free, world-configurable database).

Inspired by [this discussion](https://github.com/graphile/persisted-operations/issues/6#issuecomment-822695546)

### Motivating example

1. Have one official playground running that prospective users can play with, to see what postgraphile is like in the wild. (This should probably be completely cleared and rebooted at regular intervals, perhaps with a bit of automation from the heroku api and a stable subdomain).
2. Allow postgraphile users to quickly spin up their own playgrounds to explore prototyping concepts.
3. Allow postgraphile users to to demonstrate a minimal repro case for a bug or issue by running DDL, inserting data, and running a gql query.

### Breaking changes

None

### Supporting development

I intend to build this myself over the next week or two, but who knows life happens sometimes, so I wanted to file as an issue in case I don't get to it and someone else wants to come along and build it.

I [tick all that apply]:

- [x] am interested in building this feature myself
- [ ] am interested in collaborating on building this feature
- [x] am willing to help testing this feature before it's released
- [ ] am willing to write a test-driven test suite for this feature (before it exists)
- [x] am a [Graphile sponsor](https://www.graphile.org/sponsor/) ❤️
- [ ] have an active [support or consultancy contract](https://www.graphile.org/support/) with Graphile

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

調査の方向性

まず、Heroku Button のドキュメントと、issue で説明されている提案済みの Docker ベースのセットアップを確認します。これには、PostGraphile CLI と JavaScript の例も含まれます。新しいリポジトリから、Postgres、pgAdmin、PostGraphile、サンプルデータ、推奨される開発設定、および JavaScript の例に切り替える方法を備えた、動作する playground をデプロイできれば完了です。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
docker, graphql, javascript, postgres
領域
backend-api-design, databases, developer-experience, devops
issue の種類
機能追加
難易度
5/5
見積もり時間
1週間以上
活発さ
停滞
明瞭さ
説明が足りない
初心者へのやさしさ
25/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。