52 lines
2.4 KiB
Plaintext
52 lines
2.4 KiB
Plaintext
This is the App Engine app that serves https://crashpad.chromium.org/.
|
||
|
||
To work on this app, obtain the following packages:
|
||
|
||
- Go, from https://golang.org/dl/. This is only necessary for local development
|
||
and testing. The directory containing the “go” executable, such as
|
||
/usr/local/go/bin, must appear in $PATH. It does not appear critical for the
|
||
Go version used to match the Go runtime version used (for example, these
|
||
instructions were tested with Go 1.14 locally but a Go 1.11 runtime when
|
||
deployed), but if problems are encountered, it would be wise to use the same
|
||
version for both local development and AppEngine deployment.
|
||
- The Google Cloud SDK from, https://cloud.google.com/sdk/docs. This is
|
||
necessary for both local development and for AppEngine deployment. Unpacking
|
||
this package produces a google-cloud-sdk directory, whose bin child directory
|
||
may be added to $PATH for convenience, although this is not strictly
|
||
necessary.
|
||
|
||
The commands in this README are expected to be run from the directory containing
|
||
it. $GOPATH must also be set to include this directory:
|
||
|
||
% export GOPATH="$(go env GOPATH):$(pwd)"
|
||
|
||
To test locally:
|
||
|
||
% go get -d crashpad-home
|
||
% …/google-cloud-sdk/bin/dev_appserver.py src/crashpad-home
|
||
|
||
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. Test
|
||
http://localhost:8080/ and http://localhost:8080/doxygen to ensure that they
|
||
work.
|
||
|
||
To deploy:
|
||
|
||
% version=$(git rev-parse --short=12 HEAD)
|
||
% [[ -n "$(git status --porcelain)" ]] && version+=-dirty
|
||
% …/google-cloud-sdk/bin/gcloud app deploy \
|
||
--project=crashpad-home --version="${version}" --no-promote \
|
||
"$(pwd)/src/crashpad-home"
|
||
|
||
(Note: the $(pwd) is necessary for “gcloud app deploy” to recognize that the
|
||
application is in GOPATH, putting it into “GOPATH mode”. This normally happens
|
||
correctly on its own even with a relative path, but will fail for relative
|
||
paths when $(pwd) is a symbolic link. Using an absolute path here will save you
|
||
from this frustration, freeing you up to undoubtedly experience other
|
||
frustrations.)
|
||
|
||
Activate a newly-deployed version by visiting the App Engine console at
|
||
https://console.cloud.google.com/appengine/versions?project=crashpad-home,
|
||
selecting it, and choosing “Migrate Traffic”. It is also possible to delete old
|
||
versions from this page when they are no longer needed.
|