7bf60f09df
Replace "Go Authors" with "The Go Authors." to be consistent with the standard copyright header at https://go.dev/doc/contribute#copyright. There were also a couple instances of a double space and double "the". Change-Id: Ife7a80dd40f1a760ba85cbfee270356d46cfc53f Reviewed-on: https://go-review.googlesource.com/c/build/+/472376 TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@google.com> Run-TryBot: Dmitri Shuralyov <dmitshur@golang.org> Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org> |
||
---|---|---|
.. | ||
vcweb | ||
Dockerfile | ||
Dockerfile.apache | ||
Makefile | ||
README.md | ||
dav_svn.conf | ||
deployment.yaml |
README.md
vcs-test
We run a version control server for testing at vcs-test.golang.org
.
Repositories
The server can serve Bazaar, Fossil, Git, Mercurial, and Subversion repositories.
The root of each repository is https://vcs-test.golang.org/VCS/REPONAME
,
where VCS
is the version control system's command name (bzr
for Bazaar, and so on),
and REPONAME
is the repository name.
To serve a particular repository, the server downloads
gs://vcs-test/VCS/REPONAME.zip
from Google Cloud Storage and unzips it
into an empty directory.
The result should be a valid repository directory for the given version control system.
If the needed format of the zip file is unclear, download and inspect gs://vcs-test/VCS/hello.zip
from https://vcs-test.storage.googleapis.com/VCS/hello.zip
.
Google Cloud Storage imposes a default Cache-Control
policy of 3600 seconds for
publicly-readable objects; for instructions to disable caching per object, see
gsutil setmeta
.
vcweb
itself may serve stale data for up to five minutes after a zip file is updated.
To force a rescan of Google Cloud Storage, fetch
https://vcs-test.golang.org/VCS/REPONAME?vcweb-force-reload=1
.
Static files
The URL space https://vcs-test.golang.org/go/NAME
is served by static files,
fetched from gs://vcs-test/go/NAME.zip
.
The main use for static files is to write redirect HTML.
See gs://vcs-test/go/hello.zip
for examples.
Note that because the server uses http.DetectContentType
to deduce
the content type from file data, it is not necessary to
name HTML files with a .html
suffix.
HTTPS
The server fetches an HTTPS certificate on demand from Let's Encrypt,
using golang.org/x/crypto/acme/autocert
.
It caches the certificates in gs://vcs-test-autocert
using
golang.org/x/build/autocertcache
.