Chris Manghane | 7d85ae4 | 2013-08-01 13:23:51 +1000 | [diff] [blame] | 1 | // 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 Fitzpatrick | d5491eb | 2015-01-05 03:02:59 +0000 | [diff] [blame] | 5 | The files in these directories constitute the continuous builder: |
Chris Manghane | 7d85ae4 | 2013-08-01 13:23:51 +1000 | [diff] [blame] | 6 | |
Brad Fitzpatrick | d5491eb | 2015-01-05 03:02:59 +0000 | [diff] [blame] | 7 | app/: a.k.a the "dashboard"; the App Engine code that runs http://build.golang.org/ |
Brad Fitzpatrick | 9571310 | 2014-12-29 12:29:13 -0800 | [diff] [blame] | 8 | buildlet/: HTTP server that runs on a VM and is told what to write to disk |
Brad Fitzpatrick | d5491eb | 2015-01-05 03:02:59 +0000 | [diff] [blame] | 9 | and what command to run. This is cross-compiled to different architectures |
Brad Fitzpatrick | 9571310 | 2014-12-29 12:29:13 -0800 | [diff] [blame] | 10 | and is the first program run when a builder VM comes up. It then |
Brad Fitzpatrick | d5491eb | 2015-01-05 03:02:59 +0000 | [diff] [blame] | 11 | is contacted by the coordinator to do a build. Not all builders use |
| 12 | the buildlet (at least not yet). |
| 13 | builder/: gobuilder, a Go continuous build client. The original Go builder program. |
Brad Fitzpatrick | e428e4b | 2014-09-03 10:26:52 -0700 | [diff] [blame] | 14 | coordinator/: daemon that runs on CoreOS on Google Compute Engine and manages |
Brad Fitzpatrick | d5491eb | 2015-01-05 03:02:59 +0000 | [diff] [blame] | 15 | builds using Docker containers and/or VMs as needed. |
| 16 | env/: configuration files describing the environment of builders and related |
| 17 | binaries. Many builders are still configured ad-hoc, without a hermetic |
| 18 | environment. |
| 19 | retrybuilds/: a Go client program to delete build results from the dashboard (app) |
| 20 | types/: a Go package contain common types used by other pieces. |
Andrew Gerrand | b9fb5de | 2014-10-06 16:32:41 +1100 | [diff] [blame] | 21 | watcher/: a daemon that watches for new commits to the Go repository and |
| 22 | its sub-repositories, and notifies the dashboard of those commits. |
Chris Manghane | 7d85ae4 | 2013-08-01 13:23:51 +1000 | [diff] [blame] | 23 | |
Brad Fitzpatrick | d5491eb | 2015-01-05 03:02:59 +0000 | [diff] [blame] | 24 | If you wish to run a Go builder, please email golang-dev@googlegroups.com first. |
| 25 | There is documentation at https://golang.org/wiki/DashboardBuilders but |
| 26 | depending on the type of builder, we may want to run it ourselves, after you |
| 27 | prepare an environment description (resulting in a VM image) of it. See the env |
| 28 | directory. |
Chris Manghane | 7d85ae4 | 2013-08-01 13:23:51 +1000 | [diff] [blame] | 29 | |
Chris Manghane | 7d85ae4 | 2013-08-01 13:23:51 +1000 | [diff] [blame] | 30 | |