playground/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

```
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.
playground: add sandbox and nacl base image Change-Id: If6c2893ef8df63a3005ec85075db2e9df0cbf993 2014-12-17 23:00:26 +03:00			`# playground`

Merge sandbox and frontend into one service Since frontend was moved to the flex runtime, there is no longer a reason to keep the two separate. Consolidate the two into one service to reduce deployment complexity. Change-Id: Ie64c17e1833ed94ac8bff7381963f683d824ca5d Reviewed-on: https://go-review.googlesource.com/85456 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2017-12-24 02:02:41 +03:00			`This subrepository holds the source for the Go playground:`
			`https://play.golang.org/`
playground: add sandbox and nacl base image Change-Id: If6c2893ef8df63a3005ec85075db2e9df0cbf993 2014-12-17 23:00:26 +03:00
Merge sandbox and frontend into one service Since frontend was moved to the flex runtime, there is no longer a reason to keep the two separate. Consolidate the two into one service to reduce deployment complexity. Change-Id: Ie64c17e1833ed94ac8bff7381963f683d824ca5d Reviewed-on: https://go-review.googlesource.com/85456 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2017-12-24 02:02:41 +03:00			`## Building`
Add custom flex runtime that uses Go 1.9.2 Update golang/go#21645 Change-Id: I08a868ba3bc946bcd9dbd945806868e2613baf67 Reviewed-on: https://go-review.googlesource.com/84756 Reviewed-by: Chris Broadfoot <cbro@golang.org> 2017-12-19 20:43:27 +03:00
Refactor frontend as prep for merging sandbox and frontend Change-Id: I2c7f5c6f11134aec1fafa5d3963adfbcbc883690 Reviewed-on: https://go-review.googlesource.com/84915 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2017-12-20 03:30:25 +03:00			```
Merge sandbox and frontend into one service Since frontend was moved to the flex runtime, there is no longer a reason to keep the two separate. Consolidate the two into one service to reduce deployment complexity. Change-Id: Ie64c17e1833ed94ac8bff7381963f683d824ca5d Reviewed-on: https://go-review.googlesource.com/85456 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2017-12-24 02:02:41 +03:00			`# build the image`
			`docker build -t playground .`
Refactor frontend as prep for merging sandbox and frontend Change-Id: I2c7f5c6f11134aec1fafa5d3963adfbcbc883690 Reviewed-on: https://go-review.googlesource.com/84915 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2017-12-20 03:30:25 +03:00			```

Merge sandbox and frontend into one service Since frontend was moved to the flex runtime, there is no longer a reason to keep the two separate. Consolidate the two into one service to reduce deployment complexity. Change-Id: Ie64c17e1833ed94ac8bff7381963f683d824ca5d Reviewed-on: https://go-review.googlesource.com/85456 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2017-12-24 02:02:41 +03:00			`## Running`
playground: add sandbox and nacl base image Change-Id: If6c2893ef8df63a3005ec85075db2e9df0cbf993 2014-12-17 23:00:26 +03:00
			```
README.md: update example commands and remove redundant text 1. Pass the payload to `/compile` using `curl --upload` instead of `curl --data`. With the `--data` flag, curl encodes the data in a way that triggers the call to `(*http.Request).FormValue` (sandbox.go:56) to consume the request body. When we then attempt to decode the body as JSON (sandbox.go:58), we then fail the request with `io.EOF`. If we use the `--upload` flag instead, curl does not set the content type to the problematic `application/x-www-form-urlencoded` value, and the call to `FormValue` does not consume the body. 2. Add a name to the `docker run` command line. (That makes it easier to kill the container when we're done with it.) 3. Remove a redundant copy of the “To submit changes…” sentence. Change-Id: I314d904f626029306fecbfd25b166927dfa01029 Reviewed-on: https://go-review.googlesource.com/106215 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2018-04-11 08:01:01 +03:00			`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`
playground: add sandbox and nacl base image Change-Id: If6c2893ef8df63a3005ec85075db2e9df0cbf993 2014-12-17 23:00:26 +03:00			```

playground: update deployment instructions Change-Id: I5a43957ee86c7a068440f8d9e45c247b5ef660d1 Reviewed-on: https://go-review.googlesource.com/27080 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2016-08-16 01:36:00 +03:00			`# Deployment`
sandbox: add kubernetes and container-vm config Change-Id: I41e9adc4e35db6714aef77ddb6605f2526eecd52 Reviewed-on: https://go-review.googlesource.com/2752 Reviewed-by: Andrew Gerrand <adg@golang.org> 2015-01-14 03:39:11 +03:00
frontend: update README.md with new deployment instructions Change-Id: I01fc0052da2d8fd245d74209d10f9323d1f5a82f Reviewed-on: https://go-review.googlesource.com/85037 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2017-12-21 01:35:14 +03:00			```
Merge sandbox and frontend into one service Since frontend was moved to the flex runtime, there is no longer a reason to keep the two separate. Consolidate the two into one service to reduce deployment complexity. Change-Id: Ie64c17e1833ed94ac8bff7381963f683d824ca5d Reviewed-on: https://go-review.googlesource.com/85456 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2017-12-24 02:02:41 +03:00			`gcloud --project=golang-org --account=person@example.com app deploy app.yaml`
frontend: update README.md with new deployment instructions Change-Id: I01fc0052da2d8fd245d74209d10f9323d1f5a82f Reviewed-on: https://go-review.googlesource.com/85037 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2017-12-21 01:35:14 +03:00			```
sandbox: add kubernetes and container-vm config Change-Id: I41e9adc4e35db6714aef77ddb6605f2526eecd52 Reviewed-on: https://go-review.googlesource.com/2752 Reviewed-by: Andrew Gerrand <adg@golang.org> 2015-01-14 03:39:11 +03:00
Merge sandbox and frontend into one service Since frontend was moved to the flex runtime, there is no longer a reason to keep the two separate. Consolidate the two into one service to reduce deployment complexity. Change-Id: Ie64c17e1833ed94ac8bff7381963f683d824ca5d Reviewed-on: https://go-review.googlesource.com/85456 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2017-12-24 02:02:41 +03:00			`# Contributing`
sandbox: add kubernetes and container-vm config Change-Id: I41e9adc4e35db6714aef77ddb6605f2526eecd52 Reviewed-on: https://go-review.googlesource.com/2752 Reviewed-by: Andrew Gerrand <adg@golang.org> 2015-01-14 03:39:11 +03:00
README.md: update example commands and remove redundant text 1. Pass the payload to `/compile` using `curl --upload` instead of `curl --data`. With the `--data` flag, curl encodes the data in a way that triggers the call to `(*http.Request).FormValue` (sandbox.go:56) to consume the request body. When we then attempt to decode the body as JSON (sandbox.go:58), we then fail the request with `io.EOF`. If we use the `--upload` flag instead, curl does not set the content type to the problematic `application/x-www-form-urlencoded` value, and the call to `FormValue` does not consume the body. 2. Add a name to the `docker run` command line. (That makes it easier to kill the container when we're done with it.) 3. Remove a redundant copy of the “To submit changes…” sentence. Change-Id: I314d904f626029306fecbfd25b166927dfa01029 Reviewed-on: https://go-review.googlesource.com/106215 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org> 2018-04-11 08:01:01 +03:00			`To submit changes to this repository, see`
			`https://golang.org/doc/contribute.html.`