graphile / graphile/graphile.github.io

Postgraphile Sandbox/Playground

Abierto
#273 2 comentarios 0 reacciones 0 asignados Ver en GitHub
Lenguaje dominante
SCSS
Estrellas
27
Forks
126
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

### 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

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Línea de trabajo

Comienza revisando la documentación de Heroku Button y la configuración basada en Docker propuesta que se describe en el issue, incluidos los ejemplos de PostGraphile CLI y JavaScript. Se considerará terminado cuando un repositorio nuevo pueda desplegar un playground funcional con Postgres, pgAdmin, PostGraphile, datos de ejemplo, la configuración de desarrollo recomendada y una forma de cambiar al ejemplo de JavaScript.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
docker, graphql, javascript, postgres
Área
backend-api-design, databases, developer-experience, devops
Tipo de issue
Nueva funcionalidad
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Estancado
Claridad
Necesita aclaración
Aptitud para principiantes
25/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.