A build script, tinderbox, that automates checking out a specific version of the FreeBSD source tree and building it. A supervisor script, tbmaster, that monitors individual Tinderbox instances, logs their output, and emails failure notices. A CGI script named index.cgi that reads a set of tbmaster logs and presents an easy-to-read HTML summary of them.
![]()
The source Tinderbox consists of:
The scripts are maintained and were developed by Dag-Erling Smørgrav
<[email protected]> , and are now written in Perl, a move on from their original incarnation as shell scripts. All scripts and configuration files are kept in /projects/tinderbox/.
![]()
For more information about the tinderbox and tbmaster scripts at this stage, see their respective man pages: tinderbox(1) and tbmaster(1).
The
index.cgi script generates the HTML summary of tinderbox and tbmaster logs. Although originally intended to be used as a CGI script, as indicated by its name, this script can also be run from the command line or from a cron(8) job, in which case it will look for logs in the directory where the script is located. It will automatically detect context, generating HTTP headers when it is run as a CGI script. It conforms to XHTML standards and is styled using CSS.
The script starts in the
main() block by attempting to verify that it is running on the official Tinderbox website. If it is not, a page indicating it is not an official website is produced, and a URL to the official site is provided.
Next, it scans the log directory to get an inventory of configurations, branches and architectures for which log files exist, to avoid hard-coding a list into the script and potentially ending up with blank rows or columns. This information is derived from the names of the log files matching the following pattern:
The configurations used on the official Tinderbox build servers are named for the branches they build. For example, the
releng_8 configuration is used to build RELENG_8 as well as all still-supported release branches.
Once all of this startup procedure has been successfully completed,
do_config() is called for each configuration.
The
do_config() function generates HTML for a single Tinderbox configuration.
It works by first generating a header row, then iterating over each branch build with the specified configuration, producing a single row of results for each in the following manner:
The
success() function mentioned above scans a brief log file for the string “tinderbox run completed” in order to determine whether the build was successful.
Configurations and branches are sorted according to their branch rank. This is computed as follows:
This means that
HEAD always ranks highest, and RELENG branches are ranked in numerical order, with each STABLE branch ranking higher than the release branches forked off of it. For instance, for FreeBSD 8, the order from highest to lowest would be:
The colors that Tinderbox uses for each cell in the table are defined by CSS. Successful builds are displayed with green text; unsuccessful builds are displayed with red text. The color fades as time passes since the corresponding build, with every half an hour bringing the color closer to grey.
The official Tinderbox build servers are hosted by Sentex Data Communications, who also host the FreeBSD Netperf Cluster.
Three build servers currently exist:
freebsd-current.sentex.ca builds:
freebsd-stable.sentex.ca builds:
freebsd-legacy.sentex.ca builds:
Summaries and logs from the official build servers are available online at http://tinderbox.FreeBSD.org, hosted by Dag-Erling Smørgrav
<[email protected]> and set up as follows:
![]() Comments are closed.
|
AuthorWrite something about yourself. No need to be fancy, just an overview. Archives
January 2023
Categories |