Scroll to navigation

BUILDBOT-WORKER(1) User Commands BUILDBOT-WORKER(1)

NAME

buildbot-worker - a tool for managing buildbot worker instances

SYNOPSIS

buildbot-worker [ global options ] command [ command options ]

buildbot-worker create-worker [ -q|--quiet ] [ -f|--force ] [ -r|--relocatable ] [ -n|--no-logrotate ] [ -k|--keepalive TIME ] [ --usepty {0|1} ] [ --umask UMASK ] [ -s|--log-size SIZE ] [ -l|--log-count COUNT ] [ --verbose ] PATH MASTER USERNAME PASSWORD

buildbot-worker [ --verbose ] { start|stop|restart } [ PATH ]

buildbot-worker [ --verbose ] { --help|--version }

buildbot-worker command -h|--help

DESCRIPTION

The `buildbot-worker' command-line tool can be used to start or stop a Buildbot worker or create a new worker instance.

OPTIONS

Commands

create-worker
Create and populate a directory for a new worker
start
Start a worker
stop
Stop a worker
restart
Restart a worker

Global options

-h|--help
Print the list of available commands and global options. All subsequent commands are ignored.
--version
Print twistd and buildbot-worker version. All subsequent commands are ignored.
--verbose
Verbose output.

create-worker command options

-f|--force
Re-use an existing directory.
-h|--help
Show help for current command and exit. All subsequent commands are ignored.
-k|--keepalive
Send keepalive requests to buildmaster every TIME seconds. Default value is 600 seconds.
-l|--log-count
Limit the number of kept old twisted log files to COUNT. All files are kept by default.
-q|--quiet
Do not emit the commands being run.
-r|--relocatable
Create a relocatable buildbot.tac.
-n|--no-logrotate
Do not permit worker rotate logs by itself.
-s|--log-size
Set size at which twisted lof file is rotated to SIZE bytes. Default value is 1000000 bytes.
--umask
Set umask for files created by worker. Default value is 077 which means only owner can access the files. See umask(2) for more details.
--usepty
Set whether child processes should be run in a pty (0 means do not run in a pty). Default value is 0.
PATH
Path to worker base directory.
MASTER
Set the host and port of buildbot master to attach to in form HOST:PORT. This should be provided by buildmaster administrator.
USERNAME
Worker name to connect with. This should be provided by buildmaster administrator.
PASSWORD
Worker password to connect with. This should be provided by buildmaster administrator.

SEE ALSO

buildbot(1), umask(2),
August 2010 Buildbot