tools/dashboard
Brad Fitzpatrick d78771bc1c dashboard: create buildlet client package, move coordinator code into it
Operation Packification, step 2 of tons.

Eventually the buildlet client binary will use this stuff now.

Change-Id: I4cf5f3e6beb9e56bdc795ed513ce6daaf61425e3
Reviewed-on: https://go-review.googlesource.com/2921
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2015-01-16 16:34:20 +00:00
..
app dashboard/app: support for showing links to build-in-progress status 2015-01-09 02:12:21 +00:00
buildlet dashboard: create buildlet client package, move coordinator code into it 2015-01-16 16:34:20 +00:00
cmd dashboard: create buildlet client package, move coordinator code into it 2015-01-16 16:34:20 +00:00
env dashboard: rearrange tree, in prep for packagification 2015-01-15 02:58:11 +00:00
types dashboard/app: add a JSON output mode for the data on the front page 2015-01-05 03:57:40 +00:00
watcher dashboard/watcher: use Gerrit's JSON meta URL to poll smarter 2014-12-15 23:43:50 +00:00
README dashboard: rearrange tree, in prep for packagification 2015-01-15 02:58:11 +00:00
builders.go dashboard: create buildlet client package, move coordinator code into it 2015-01-16 16:34:20 +00:00
builders_test.go dashboard: create buildlet client package, move coordinator code into it 2015-01-16 16:34:20 +00:00

README

// Copyright 2009 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

The files in these directories constitute the continuous builder:

app/: a.k.a the "dashboard"; the App Engine code that runs http://build.golang.org/

cmd/:

  buildlet/: HTTP server that runs on a VM and is told what to write to disk
           and what command to run. This is cross-compiled to different architectures
           and is the first program run when a builder VM comes up. It then
           is contacted by the coordinator to do a build. Not all builders use
           the buildlet (at least not yet).

  builder/: gobuilder, a Go continuous build client. The original Go builder program.

  coordinator/: daemon that runs on CoreOS on Google Compute Engine and manages
          builds using Docker containers and/or VMs as needed.

  retrybuilds/: a Go client program to delete build results from the dashboard (app)

  upload/:  a Go program to upload to Google Cloud Storage. used by Makefiles elsewhere.

  watcher/: a daemon that watches for new commits to the Go repository and
          its sub-repositories, and notifies the dashboard of those commits.

env/:     configuration files describing the environment of builders and related
          binaries. Many builders are still configured ad-hoc, without a hermetic
          environment.

types/:   a Go package contain common types used by other pieces.


If you wish to run a Go builder, please email golang-dev@googlegroups.com first.
There is documentation at https://golang.org/wiki/DashboardBuilders but
depending on the type of builder, we may want to run it ourselves, after you
prepare an environment description (resulting in a VM image) of it. See the env
directory.