Add a README for the App Engine app with notes for maintaining it

R=andybons@chromium.org

Review URL: https://codereview.chromium.org/1416833003 .
This commit is contained in:
Mark Mentovai 2015-10-21 11:20:10 -04:00
parent 0ed0106aa4
commit af8c7fcbee
2 changed files with 39 additions and 1 deletions

39
doc/appengine/README Normal file
View File

@ -0,0 +1,39 @@
This is the App Engine app that serves https://crashpad-home.appspot.com/.
To work on this app, obtain the App Engine SDK for Go from
https://cloud.google.com/appengine/downloads. Unpacking it produces a
go_appengine directory. This may be added to your $PATH for convenience,
although it is not necessary.
The commands in this README are expected to be run from the directory containing
app.yaml.
The App Engine SDK for Go provides App Engine packages at the “appengine” import
path, but not the newer “google.golang.org/appengine” path. The Crashpad app
uses the newer paths. See
https://github.com/golang/appengine#2-update-import-paths and
https://code.google.com/p/googleappengine/issues/detail?id=11670. To make these
available, obtain a Go release from https://golang.org/dl/, and run:
$ GOROOT=…/go_appengine/goroot GOPATH=…/go_appengine/gopath go get -d
To test locally:
$ goapp serve
Look for the “Starting module "default" running at: http://localhost:8080” line,
which tells you the URL of the local running instance of the app.
To deploy:
$ version=$(git rev-parse --short=12 HEAD)
$ [[ -n "$(git status --porcelain)" ]] && version+=-dirty
$ goapp deploy -version "${version}"
Note that app.yaml does not name a “version” to encourage you to use a git hash
as the version, as above.
Activate a newly-deployed version by visiting the App Engine console at
https://appengine.google.com/deployment?&app_id=s~crashpad-home, selecting it,
and choosing “Make Default”. It is also possible to delete old versions from
this page when they are no longer needed.

View File

@ -1,5 +1,4 @@
application: crashpad-home
version: 1
runtime: go
api_version: go1