buildbot - a tool for managing buildbot master instances
buildbot [ global options ] command [
command options ]
buildbot command -h|--help
buildbot create-master [ -q|--quiet ] [
-f|--force ] [ -r|--relocatable ] [
-n|--no-logrotate ] [ -s|--log-size SIZE
] [ -l|--log-count COUNT ] [ -c|--config
CONFIG ] [ --db DATABASE ] [ PATH ]
buildbot upgrade-master [ -q|--quiet ] [
-r|--replace ] [ --db DATABASE ] [ PATH
]
buildbot [ --verbose ] {
start|stop|restart|sighup|reconfig } [
PATH ]
buildbot sendchange [ -m|--master
MASTER ] [ -u|--username USERNAME ] [
-R|--repository REPOSITORY ] [
-P|--project PROJECT ] [ -b|--branch
BRANCH ] [ -C|--category CATEGORY ] [
-r|--revision REVISION ] [ --revision-file
REVISIONFILE ] [ -p|--property PROPERTY ] [
-c|--comments MESSAGE ] [ -F|--logfile
LOGFILE ] [ -w|--when TIMESTAMP ]
FILES...
buildbot try [ --wait ] [ -n|--dry-run
] [ --get-builder-names ] [ -c|--connect {ssh|pb} ] [
--tryhost HOSTNAME ] [ --trydir PATH ] [
-m|--master MASTER ] [ -u|--username
USERNAME ] [ --passwd PASSWORD ] [ --diff
DIFF ] [ --patchlevel PATCHLEVEL ] [ --baserev
BASEREV ] [ --vc {cvs|svn|tla|baz|darcs|p4} ] [
--branch BRANCH ] [ -b|--builder BUILDER
] [ --properties PROPERTIES ] [ --try-topfile
FILE ] [ --try-topdir PATH ]
buildbot tryserver [ --jobdir PATH ]
buildbot checkconfig [ CONFIGFILE ]
buildbot [ --verbose ] {
start|stop|restart|sighup|reconfig } [
PATH ]
buildbot [ --verbose ] {
--help|--version }
The `buildbot' command-line tool can be used to start or stop a
buildmaster and to interact with a running buildmaster instance. Some of its
subcommands are intended for buildmaster admins, while some are for
developers who are editing the code that the buildbot is monitoring.
- create-master
- Create and populate a directory for a new buildmaster
- upgrade-master
- Upgrade an existing buildmaster directory for the current version
- start
- Start a buildmaster
- stop
- Stop a buildmaster
- restart
- Restart a buildmaster
- sighup|reconfig
- Send SIGHUP signal to buildmaster to make it re-read the config file
- sendchange
- Send a change to the buildmaster
- 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.
- tryserver
- buildmaster-side ´try´ support function, not for users
- checkconfig
- Validate buildbot master config file.
- -h|--help
- Print the list of available commands and global options. All subsequent
commands are ignored.
- --version
- Print Buildbot and Twisted versions. All subsequent commands are
ignored.
- --verbose
- Verbose output.
- -q|--quiet
- Do not emit the commands being run
- -f|--force
- Re-use an existing directory (will not overwrite master.cfg file)
- -r|--relocatable
- Create a relocatable buildbot.tac
- -n|--no-logrotate
- Do not permit buildmaster rotate logs by itself.
- -c|--config
- Set name of the buildbot master config file to CONFIG. Default file
name is master.cfg.
- -s|--log-size
- Set size at which twisted lof file is rotated to SIZE bytes.
Default value is 1000000 bytes.
- -l|--log-count
- Limit the number of kept old twisted log files to COUNT. All files
are kept by default.
- --db
- Set the database connection for storing scheduler/status state to
DATABASE. Default value is sqlite:///state.sqlite.
- PATH
- Directory where buildbot master files will be stored.
- -q|--quiet
- Do not emit the commands being run.
- -r|--replace
- Replace any modified files without confirmation.
- --db
- Set the database connection for storing scheduler/status state to
DATABASE. Default value is sqlite:///state.sqlite.
- PATH
- Directory where buildbot master files are stored.
- --wait
- Wait until the builds have finished.
- -n|--dry-run
- Gather info, but don't actually submit.
- --get-builder-names
- Get the names of available builders. Doesn't submit anything. Only
supported for 'pb' connections.
- -c|--connect
- Connection type. Can be either ´ssh´ or
´pb´.
- --tryhost
- Set the hostname (used by ssh) for the buildmaster to
HOSTNAME.
- --trydir
- Specify trydir (on the tryhost) where tryjobs are deposited.
- -m|--master
- Set the location of the buildmaster's try scheduler in form
HOST:PORT
- -u|--username
- Set the username performing the trial build to USERNAME.
- --passwd
- Set password for PB authentication to PASSWORD.
- --diff
- Use DIFF file to use as a patch instead of scanning a local tree.
Use ´-´ for stdin.
- --patchlevel
- Specify the patchlevel to apply with. Defaults to 0. See patch for
details.
- --baserev
- Use BASEREV revision instead of scanning a local tree.
- --vc
- Specify version control system in use. Possible values: cvs, svn, tla,
baz, darcs, p4.
- --branch
- Specify the branch in use, for VC systems that can't figure it out
themselves.
- -b|--builder
- Run the trial build on the specified Builder. Can be used multiple
times.
- --properties
- Specify the set of properties made available in the build environment in
format prop1=value1,prop2=value2...
- --try-topfile
- Specify name of a file at the top of the tree. This option is used to find
the top. Only needed for SVN and CVS.
- --try-topdir
- Specify the path to the top of the working copy. Only needed for SVN and
CVS.
- --jobdir
- The jobdir (maildir) for submitting jobs