buildbot man page

buildbot — a tool for managing buildbot master instances

Synopsis

General Invocation

buildbot [ global options ] command [ command options ]

buildbot command -h|--help

Command Options

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 }

Description

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.

Options

Commands

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.

Global options

-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.

create-master command options

-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.

upgrade-master command options

-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.

sendchange command options

--master

Set the location of buildmaster's PBChangeSource to attach to in form HOST:PORT.

-u|--username

Set committer's username to USERNAME.

-R|--repository

Set repository URL to REPOSITORY.

-P|--project

Set project specifier to PROJECT.

-b|--branch

Set branch name to BRANCH.

-c|--category

Set category of repository to CATEGORY.

-r|--revision

Set revision being built to REVISION.

--revision-file

Use REVISIONFILE file to read revision spec data from.

-p|--property

Set property for the change to PROPERTY. It should be in format NAME:VALUE.

-m|--comments

Set log message to MESSAGE.

-F|--logfile

Set logfile to LOGFILE.

-w|--when

Set timestamp used as the change time to TIMESTAMP.

FILES

Lis of files have been changed.

try command options

--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.

tryserver command options

--jobdir

The jobdir (maildir) for submitting jobs

Files

master.cfg

Buildbot master configuration file

See Also

buildbot-worker(1), patch(1)

Referenced By

buildbot-worker(1).

August 2010 Buildbot User Commands