README

playground

Go Reference

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

Building

# build the image
docker build -t golang/playground .

Running

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

Deployment

Deployment Triggers

Playground releases automatically triggered when new Go repository tags are pushed to GitHub, or when master is pushed on the playground repository.

For details, see deploy/go_trigger.json, deploy/playground_trigger.json, and deploy/deploy.json.

After making changes to trigger configuration, update configuration by running the following Make target:

make update-cloudbuild-trigger
Deploy via Cloud Build

The Cloud Build configuration will always build and deploy with the latest supported release of Go.

gcloud builds submit --config deploy/deploy.json .
Deploy via gcloud app deploy

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

Alternatively, to avoid Cloud Build and build locally:

make docker
docker tag golang/playground:latest gcr.io/golang-org/playground:latest
docker push gcr.io/golang-org/playground:latest
gcloud --project=golang-org --account=you@google.com app deploy app.yaml --image-url=gcr.io/golang-org/playground:latest

Then:

gcloud --project=golang-org --account=you@google.com app deploy app.yaml

Contributing

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

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
cmd
latestgo
latestgo prints the latest Go release tag to stdout as a part of the playground deployment process.
latestgo prints the latest Go release tag to stdout as a part of the playground deployment process.
The sandbox program is an HTTP server that receives untrusted linux/amd64 binaries in a POST request and then executes them in a gvisor sandbox using Docker, returning the output as a response to the POST.
The sandbox program is an HTTP server that receives untrusted linux/amd64 binaries in a POST request and then executes them in a gvisor sandbox using Docker, returning the output as a response to the POST.
sandboxtypes
The sandboxtypes package contains the shared types to communicate between the different sandbox components.
The sandboxtypes package contains the shared types to communicate between the different sandbox components.
gcpdial
Package gcpdial monitors VM instance groups to let frontends dial them directly without going through an internal load balancer.
Package gcpdial monitors VM instance groups to let frontends dial them directly without going through an internal load balancer.
gcpdial/gcpdialtool
The gcpdialtool command is an interactive validation tool for the gcpdial packge.
The gcpdialtool command is an interactive validation tool for the gcpdial packge.
metrics
Package metrics provides a service for reporting metrics to Stackdriver, or locally during development.
Package metrics provides a service for reporting metrics to Stackdriver, or locally during development.