Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(89)

Unified Diff: doc/appengine/README

Issue 1416833003: Add a README for the App Engine app with notes for maintaining it (Closed) Base URL: https://chromium.googlesource.com/crashpad/crashpad@master
Patch Set: Created 5 years, 2 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « no previous file | doc/appengine/app.yaml » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: doc/appengine/README
diff --git a/doc/appengine/README b/doc/appengine/README
new file mode 100644
index 0000000000000000000000000000000000000000..d3f4d2270c51e1a3b849f9d1ce1a9cdb422490b4
--- /dev/null
+++ b/doc/appengine/README
@@ -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.
« no previous file with comments | « no previous file | doc/appengine/app.yaml » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698