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 ] [ --delete-leftover-dirs ] [ --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.
--delete-leftover-dirs: Set to remove unexpected directories in worker base directory.
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.