buildbot

Langue: en

Version: November 2009 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

NAME

Buildbot - manual page for Buildbot version: 0.7.11p3

SYNOPSIS

buildbot [global options] <command> [command options]

The `buildbot' command-line tool can be used to start or stop a buildmaster or buildbot, and to interact with a running buildmaster. Some of its subcommands are intended for buildmaster admins, while some are for developers who are editing the code that the buildbot is monitoring.

OPTIONS

These are the global buildbot options:

--version
--help
Display this help and exit.
--verbose

Administrator commands:

create-master
Create and populate a directory for a new buildmaster:
 buildbot create-master [--quiet] [--force] [--config=FILE]
     [--log-size=SIZE] [--log-count=COUNT] BASEDIR
 
upgrade-master
Upgrade an existing buildmaster directory for the current version. When this command is finished, the buildmaster directory should look much like a brand-new one created by the 'create-master' command.
buildbot upgrade-master [--quiet] [--replace] BASEDIR
create-slave
Create and populate a directory for a new buildslave
 buildbot create-slave BASEDIR MASTERHOST:PORT
     SLAVENAME PASSWORD
 
start
Start a buildmaster or buildslave
buildbot start [--quiet] BASEDIR
stop
Stop a buildmaster or buildslave
buildbot stop [--quiet] BASEDIR
restart
Restart a buildmaster or buildslave
buildbot restart [--quiet] BASEDIR
reconfig
SIGHUP a buildmaster to make it re-read the config file. The sighup command is an alias for this command.
buildbot reconfig [--quiet] BASEDIR
checkconfig
test the validity of a master.cfg config file
buildbot checkconfig [CONFIG_FILE]
tryserver
buildmaster-side 'try' support function, not for users

Buildmaster debug commands

These commands are also used by buildmaster administrators but not an day-to-day basis.

sendchange
Send a change to the buildmaster. The buildmaster must have been configured already to accept changes.
 buildbot sendchange --master=HOST:PORT --username=USERNAME
     [--branch=BRANCH] [--category=CATEGORY]
     [--revision=STRING | --revision-number=NUMBER |
      --revision-file=FILENAME ] [--comments=LOG_MESSAGE ]
     [--when=TIMESTAMP] FILENAMES...
 
debugclient
Launch a small debug panel GUI
buildbot debuclient [--master=HOST:PORT] [--passwd=PASSWORD]

Developer commands:

statuslog
Emit current builder status to stdout
buildbot statuslog [--master=HOST:PORT]
statusgui
Display a small window showing current builder status
buildbot statusgui [--master=HOST:PORT]
try
Run a build with your local changes. This command requires in-advance configuration of the buildmaster to accept such build requests. Please see the documentation for details about this command.

SEE ALSO

The full documentation for Buildbot is maintained as a Texinfo manual. If the info and Buildbot programs are properly installed at your site, the command
info Buildbot

should give you access to the complete manual.

AUTHOR

This manual page was written by Iustin Pop <iusty@k1024.org>, for the Debian project (and may be used by others).