| commit | a07c284bcf333dc17a1489fd441e8fccf1e01c2a | [log] [tgz] |
|---|---|---|
| author | Dmitri Shuralyov <dmitshur@golang.org> | Mon Feb 08 13:19:29 2021 -0500 |
| committer | Dmitri Shuralyov <dmitshur@golang.org> | Mon Feb 08 21:42:16 2021 +0000 |
| tree | 06ba5d0e3ce1290e0089a7745765913a1e45329d | |
| parent | cd4111d5df24d7371a270187581e15b162c598e0 [diff] |
README: update deployment instructions for module mode The go.mod file did not provide all dependencies before the glcoud deploy step, because there was no go mod tidy or go get step after rsync was used to copy the golang.org/x/tools/cmd/present command. The previous deploy instructions assumed a GOPATH layout where ../tools is a checkout of the golang.org/x/tools repository. That may still hold today, but it's hard to control or predict what commit will be checked out at that path. It's also hard to arrange that the same version of x/tools is used for the present command as well as its dependencies. Change the approach to use go get to select the version of x/tools that provides the golang.org/x/tools/cmd/present command intended for deployment. Also rewrite the deployment into numbered steps. Change the README format to use Markdown and expand some general sections to be more consistent with our READMEs in other repos. Fixes golang/go#44164. Updates golang/go#36825. Change-Id: Ibf01b076d6a6767184d092cbd7116c20007c8fa7 Reviewed-on: https://go-review.googlesource.com/c/talks/+/290192 Trust: Dmitri Shuralyov <dmitshur@golang.org> Reviewed-by: Alexander Rakoczy <alex@golang.org>
This repository holds various Go talks that may be viewed with the present tool.
To install the present tool, use go get:
go get golang.org/x/tools/cmd/present
To view talks, run present in the content directory and then visit http://127.0.0.1:3999 in your browser.
This repository uses Gerrit for code changes. To learn how to submit changes to this repository, see https://golang.org/doc/contribute.html.
The main issue tracker for the talks repository is located at https://github.com/golang/go/issues. Prefix your issue with “x/talks:” in the subject line, so it is easy to find.
To deploy these talks to talks.golang.org hosted on App Engine:
Add a version of golang.org/x/tools/cmd/present that you intend to use in this deploy as a dependency of this module:
go get -d golang.org/x/tools/cmd/present@latest
Copy the contents of golang.org/x/tools/cmd/present to the root of this repository:
rsync -r $(go list -f '{{.Dir}}' golang.org/x/tools/cmd/present)/ .
Run the deploy:
GO111MODULE=on gcloud --project=golang-org app deploy --no-promote app.yaml
This will create a new version, which can be viewed within the golang-org GCP project.
Check that the deployed version looks OK (click the version link in GCP).
If all is well, click “Migrate Traffic” to move 100% of the talks.golang.org traffic to the new version.
Clean up the local file modifications that steps 1 and 2 caused.
You're done.