README: document the need to increase cloud build timeout

It's unfortunate to introduce an extra step of setting a global
configuration value to the deploy process. It would be better if
this could be an application-scoped setting specified in the app.yaml
configuration. However, that doesn't seem to be possible, and after
reading through documentation and waiting to hear any suggestions at
golang/go#28046, I have not become aware of a better solution.

Document this approach for now, and if we learn of a better solution
in the future, this can be improved then.

Fixes golang/go#28046

Change-Id: I2e9b7bbd38aa8313ff6eab0bf99dd2fe48f57544
Reviewed-on: https://go-review.googlesource.com/c/playground/+/164577
Reviewed-by: Andrew Bonventre <andybons@golang.org>
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
1 file changed
tree: e6c02d8862461b7cd7eef52eb51f707f10fdf91c
  1. AUTHORS
  2. CONTRIBUTING.md
  3. CONTRIBUTORS
  4. Dockerfile
  5. LICENSE
  6. Makefile
  7. PATENTS
  8. README.md
  9. app.yaml
  10. cache.go
  11. client.go
  12. codereview.cfg
  13. edit.go
  14. edit.html
  15. enable-fake-time.patch
  16. fake_fs.lst
  17. fmt.go
  18. logger.go
  19. main.go
  20. play.go
  21. play_test.go
  22. sandbox.go
  23. server.go
  24. server_test.go
  25. share.go
  26. static/
  27. store.go
  28. vet.go
README.md

playground

This subrepository holds the source for the Go playground: https://play.golang.org/

Building

# build the image
docker build -t playground .

Running

docker run --name=play --rm -d -p 8080:8080 playground
# run some Go code
cat /path/to/code.go | go run client.go | curl -s --upload-file - localhost:8080/compile

Deployment

Building the playground Docker container takes more than the default 10 minute time limit of cloud build, so increase its timeout first (note, app/cloud_build_timeout is a global configuration value):

gcloud config set app/cloud_build_timeout 1200  # 20 mins

Then:

gcloud --project=golang-org --account=person@example.com app deploy app.yaml

Contributing

To submit changes to this repository, see https://golang.org/doc/contribute.html.