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. static/
  2. app.yaml
  3. AUTHORS
  4. cache.go
  5. client.go
  6. codereview.cfg
  7. CONTRIBUTING.md
  8. CONTRIBUTORS
  9. Dockerfile
  10. edit.go
  11. edit.html
  12. enable-fake-time.patch
  13. fake_fs.lst
  14. fmt.go
  15. LICENSE
  16. logger.go
  17. main.go
  18. Makefile
  19. PATENTS
  20. play.go
  21. play_test.go
  22. README.md
  23. sandbox.go
  24. server.go
  25. server_test.go
  26. share.go
  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.