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>
1 file changed
tree: 70baf6ec30cbc3741c6c7a2afa3e281ca044b9fb
  1. AUTHORS
  2. CONTRIBUTING.md
  3. CONTRIBUTORS
  4. LICENSE
  5. PATENTS
  6. README.md
  7. codereview.cfg
  8. frontend/
  9. sandbox/
README.md

playground

This subrepository holds the source for various packages and tools that support the Go playground: https://play.golang.org/

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

Frontend

Building

# build the frontend image
docker build -t frontend frontend/

Running with an in-memory store

docker run --rm -d -p 8080:8080 frontend

Running with the Cloud Datastore Emulator

# install it if needed
gcloud components install cloud-datastore-emulator
# run the datastore emulator
gcloud --project=golang-org beta emulators datastore start
# set env vars
$(gcloud beta emulators datastore env-init)
# run the frontend
cd frontend && go install && frontend

Now visit localhost:8080 to ensure it worked.

# unset any env vars once finished
$(gcloud beta emulators datastore env-unset)

Sandbox

Building

# build the sandbox image
docker build -t sandbox sandbox/

Running

# run the sandbox
docker run -d -p 8080:8080 sandbox
# get docker host ip, try boot2docker fallback on localhost.
DOCKER_HOST_IP=$(boot2docker ip || echo localhost)
# run go some code
cat /path/to/code.go | go run ./sandbox/client.go | curl --data @- $DOCKER_HOST_IP:8080/compile

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

Deployment

gcloud --project=golang-org --account=person@example.com app deploy frontend/app.yaml
gcloud --project=golang-org --account=person@example.com app deploy sandbox/app-flex.yaml --no-promote

Use the Cloud Console's to set the new version as the default: https://cloud.google.com/console/appengine/versions?project=golang-org&moduleId=sandbox-flex Then test that play.golang.org and tour.golang.org are working before deleting the old version.