blob: d9f62bef3b368fb85b98c7c072044f3755d5866c [file] [log] [blame]
Chris Manghane7d85ae42013-08-01 13:23:51 +10001// Copyright 2009 The Go Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style
3// license that can be found in the LICENSE file.
4
Brad Fitzpatrickd5491eb2015-01-05 03:02:59 +00005The files in these directories constitute the continuous builder:
Chris Manghane7d85ae42013-08-01 13:23:51 +10006
Brad Fitzpatrickd5491eb2015-01-05 03:02:59 +00007app/: a.k.a the "dashboard"; the App Engine code that runs http://build.golang.org/
Brad Fitzpatrick95713102014-12-29 12:29:13 -08008buildlet/: HTTP server that runs on a VM and is told what to write to disk
Brad Fitzpatrickd5491eb2015-01-05 03:02:59 +00009 and what command to run. This is cross-compiled to different architectures
Brad Fitzpatrick95713102014-12-29 12:29:13 -080010 and is the first program run when a builder VM comes up. It then
Brad Fitzpatrickd5491eb2015-01-05 03:02:59 +000011 is contacted by the coordinator to do a build. Not all builders use
12 the buildlet (at least not yet).
13builder/: gobuilder, a Go continuous build client. The original Go builder program.
Brad Fitzpatricke428e4b2014-09-03 10:26:52 -070014coordinator/: daemon that runs on CoreOS on Google Compute Engine and manages
Brad Fitzpatrickd5491eb2015-01-05 03:02:59 +000015 builds using Docker containers and/or VMs as needed.
16env/: configuration files describing the environment of builders and related
17 binaries. Many builders are still configured ad-hoc, without a hermetic
18 environment.
19retrybuilds/: a Go client program to delete build results from the dashboard (app)
20types/: a Go package contain common types used by other pieces.
Andrew Gerrandb9fb5de2014-10-06 16:32:41 +110021watcher/: a daemon that watches for new commits to the Go repository and
22 its sub-repositories, and notifies the dashboard of those commits.
Chris Manghane7d85ae42013-08-01 13:23:51 +100023
Brad Fitzpatrickd5491eb2015-01-05 03:02:59 +000024If you wish to run a Go builder, please email golang-dev@googlegroups.com first.
25There is documentation at https://golang.org/wiki/DashboardBuilders but
26depending on the type of builder, we may want to run it ourselves, after you
27prepare an environment description (resulting in a VM image) of it. See the env
28directory.
Chris Manghane7d85ae42013-08-01 13:23:51 +100029
Chris Manghane7d85ae42013-08-01 13:23:51 +100030