[Buildbot-commits] buildbot/docs buildbot.texinfo,1.111,1.112
Brian Warner
warner at users.sourceforge.net
Wed Aug 1 22:09:27 UTC 2007
- Previous message (by thread): [Buildbot-commits] buildbot/buildbot/status/web base.py, 1.4, 1.5 baseweb.py, 1.9, 1.10 build.py, 1.4, 1.5 builder.py, 1.3, 1.4 logs.py, 1.3, 1.4 step.py, 1.3, 1.4
- Next message (by thread): [Buildbot-commits] buildbot ChangeLog,1.887,1.888
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]
Update of /cvsroot/buildbot/buildbot/docs
In directory sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv29781/docs
Modified Files:
buildbot.texinfo
Log Message:
[project @ web: update buildbot.texinfo, update nodes/menus with the new contents]
Original author: warner at lothar.com
Date: 2007-08-01 19:26:47+00:00
Index: buildbot.texinfo
===================================================================
RCS file: /cvsroot/buildbot/buildbot/docs/buildbot.texinfo,v
retrieving revision 1.111
retrieving revision 1.112
diff -u -d -r1.111 -r1.112
--- buildbot.texinfo 1 Aug 2007 22:07:54 -0000 1.111
+++ buildbot.texinfo 1 Aug 2007 22:09:25 -0000 1.112
@@ -237,10 +237,16 @@
Status Delivery
* HTML Waterfall::
+* WebStatus::
* IRC Bot::
* PBListener::
* Writing New Status Plugins::
+WebStatus
+
+* Buildbot Web Resources::
+* XMLRPC server::
+
Command-line tool
* Administrator Tools::
@@ -5810,6 +5816,7 @@
@menu
* HTML Waterfall::
+* WebStatus::
* IRC Bot::
* PBListener::
* Writing New Status Plugins::
@@ -5820,7 +5827,7 @@
@c DOCUMENT THIS
- at node HTML Waterfall, IRC Bot, Status Delivery, Status Delivery
+ at node HTML Waterfall, WebStatus, Status Delivery, Status Delivery
@section HTML Waterfall
@cindex Waterfall
@@ -5923,27 +5930,36 @@
@file{public_html/robots.txt} and @file{public_html/buildbot.css} are
useful things to create.
-All URLs that start with @file{_buildbot/} will be handled by code
-internal to the buildbot. The pages available in this space provide
-various views into the buildbot status, each with a different focus.
-These pages can be configured further by adding query arguments, for
-example to restrict the page to only display certain Builders, or
-limit it to builds of a specific branch.
+Certain URL prefixes are handled specially by code within the
+buildbot. The pages available in these spaces provide various views into
+the buildbot status, each with a different focus. These pages can be
+configured further by adding query arguments, for example to restrict
+the page to only display certain Builders, or limit it to builds of a
+specific branch.
In addition, if you are familiar with twisted.web @emph{Resource
Trees}, you can write code to add additional pages at places inside
-this web space. Just use @code{webstatus.root.putChild} to places
-these resources.
+this web space. Just use @code{webstatus.putChild} to place these
+resources.
+
+The following section describes the special URLs and the status views
+they provide.
+ at menu
+* Buildbot Web Resources::
+* XMLRPC server::
+ at end menu
+
@node Buildbot Web Resources, XMLRPC server, WebStatus, WebStatus
@subsection Buildbot Web Resources
-All URLs that start with @file{_buildbot/} are handled by various
-classes in the @file{buildbot.status.web} package. The most common way
-to access these pages is for the buildmaster admin to write or modify
-the @file{index.html} page to contain links to them. Of course other
-project web pages can contain links to these buildbot pages as well.
+Certain URLs are ``magic'', and the pages they serve are created by
+various classes in the @file{buildbot.status.web} package instead of
+being read from disk. The most common way to access these pages is for
+the buildmaster admin to write or modify the @file{index.html} page to
+contain links to them. Of course other project web pages can contain
+links to these buildbot pages as well.
Each page can be modified by adding query arguments to the URL. For
example, a page which shows the results of the most recent build
@@ -5957,15 +5973,17 @@
Some pages may include the Builder name or the build number in the
main part of the URL itself. For example, a page that describes Build
-#7 of the ``i386'' builder might live at
- at file{_buildbot/builders/i386/builds/7}.
+#7 of the ``i386'' builder would live at @file{/builders/i386/builds/7}.
The table below lists all of the internal pages and the URLs that can
be used to access them.
+NOTE: of the pages described here, only the @code{/waterfall} and
+ at code{/builders} are implemented yet.
+
@table @code
- at item /_buildbot/timeline
+ at item /waterfall
This provides a chronologically-oriented display of the activity of
all builders. It is the same display used by the Waterfall display.
@@ -5973,7 +5991,35 @@
By adding one or more ``builder='' arguments, the Waterfall is
restricted to only showing information about the given Builders.
- at item /_buildbot/one_line_per_build
+The Waterfall has references to resources in the @file{/builders}
+portion of the URL space to give access to individual builds.
+
+ at item /builders/$BUILDERNAME/
+
+This describes the given Builder, and provides buttons to force a build.
+
+ at item /builders/$BUILDERNAME/builds/$BUILDNUM/
+
+This describes a specific Build.
+
+ at item /builders/$BUILDERNAME/builds/$BUILDNUM/steps/$STEPNAME
+
+This describes a specific BuildStep.
+
+ at item /builders/$BUILDERNAME/builds/$BUILDNUM/steps/$STEPNAME/logs/$LOGNAME
+
+This provides an HTML representation of a specific logfile.
+
+ at item /builders/$BUILDERNAME/builds/$BUILDNUM/steps/$STEPNAME/logs/$LOGNAME/text
+
+This returns the logfile as plain text, without any HTML coloring
+markup. It also removes the ``headers'', which are the lines that
+describe what command was run and what the environment variable
+settings were like. This maybe be useful for saving to disk and
+feeding to tools like 'grep'.
+
+
+ at item /one_line_per_build
This page shows one line of text for each build, merging information
from all Builders at footnote{Apparently this is the same way
@@ -5981,19 +6027,14 @@
the name of the Builder, the number of the Build, what revision it
used, and a summary of the results. Successful builds are in green,
while failing builds are in red. The date and time of the build are
-added to the right-hand edge of the line.
+added to the right-hand edge of the line. The lines are ordered by
+build finish timestamp.
One of more ``builder='' arguments can be used to restrict the list.
In addition, a ``numbuilds='' argument will control how many lines are
displayed (20 by default).
- at item /_buildbot/one_line_per_build/$BUILDERNAME
-
-By adding the name of a single Builder to the URL, the
-one_line_per_build display is restricted to just that one Builder. The
-``numbuilds='' argument is still relevant.
-
- at item SlaveStatusTimeline
+ at item /slave_status_timeline
This provides a chronological display of configuration and operational
events: master startup/shutdown, slave connect/disconnect, and
@@ -6003,7 +6044,7 @@
This page does not show any builds.
- at item LastBuild
+ at item /last_build
This shows one box per Builder, showing the results of the most recent
complete build. It does not show the individual steps, or the current
@@ -6018,7 +6059,7 @@
@end itemize
- at item LastBuildImage
+ at item /last_build/$BUILDERNAME/status.png
This returns a PNG image that describes the results of the most recent
build, which can be referenced in an IMG tag by other pages, perhaps
@@ -6031,11 +6072,7 @@
@table @code
- at item RSS
-
-This provides an RSS feed of recent builds.
-
- at item /_buildbot/xmlrpc
+ at item /xmlrpc
This runs an XML-RPC server which can be used to query status
information about various builds. See @xref{XMLRPC server} for more
@@ -6047,16 +6084,16 @@
@subsection XMLRPC server
When using WebStatus, the buildbot runs an XML-RPC server at
- at file{/_buildbot/xmlrpc} that can be used by other programs to query
-build status. The following table lists the methods that can be
-invoked using this interface.
+ at file{/xmlrpc} that can be used by other programs to query build
+status. The following table lists the methods that can be invoked
+using this interface.
@table @code
@end table
- at node IRC Bot, PBListener, HTML Waterfall, Status Delivery
+ at node IRC Bot, PBListener, WebStatus, Status Delivery
@section IRC Bot
@cindex IRC
- Previous message (by thread): [Buildbot-commits] buildbot/buildbot/status/web base.py, 1.4, 1.5 baseweb.py, 1.9, 1.10 build.py, 1.4, 1.5 builder.py, 1.3, 1.4 logs.py, 1.3, 1.4 step.py, 1.3, 1.4
- Next message (by thread): [Buildbot-commits] buildbot ChangeLog,1.887,1.888
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]
More information about the Commits
mailing list