tree: b63c794cf37f867a1e147e2914969c89666b1420 [path history] [tgz]
  1. src/
  2. BUILD
  3. README.md
src/tools/dash/README.md

A Dashboard for Bazel

This is a self-hosted dashboard for Bazel. In particular, this runs a server that turns build results and logs into webpages.

Running the server

Build and run the server:

$ bazel build //src/tools/dash:dash
$ bazel-bin/src/tools/dash

Once you see the log message INFO: Dev App Server is now running, you can visit [http://localhost:8080] to see the main page (which should say “No builds, yet!”).

This builds a .war file that can be deployed to AppEngine (although this doc assumes you'll run it locally).

Note: as of this writing, there is no authentication, rate limiting, or other protection for the dashboard. Anyone who can access the URL can read and write data to it. You may want to specify the --address or --host option (depending on AppEngine SDK version) when you run dash to bind the server to an internal network address.

Configuring Bazel to write results to the dashboard

You will need to tell Bazel where to send build results. Run bazel with the --use_dash and --dash_url=http://localhost:8080 flags, for example:

$ bazel build --use_dash --dash_url=http://localhost:8080 //foo:bar

If you don't want to have to specify the flags for every build and test, add the following lines to your .bazelrc (either in your home directory, ~/.bazelrc, or on a per-project basis):

build --use_dash
build --dash_url=http://localhost:8080

Then build results will be sent to the dashboard by default. You can specify --use_dash=false for a particular build if you don't want it sent.

Please email the mailing list with any questions or concerns.