Many of the buildbot tools must be told how to contact the
buildmaster that they interact with. This specification can be
provided as a command-line argument, but most of the time it will be
easier to set them in an “options” file. The buildbot
command will look for a special directory named .buildbot,
starting from the current directory (where the command was run) and
crawling upwards, eventually looking in the user's home directory. It
will look for a file named options in this directory, and will
evaluate it as a python script, looking for certain names to be set.
You can just put simple
name = 'value' pairs in this file to
set the options.
For a description of the names used in this file, please see the documentation for the individual buildbot sub-commands. The following is a brief sample of what this file's contents could be.
# for status-reading tools masterstatus = 'buildbot.example.org:12345' # for 'sendchange' or the debug port master = 'buildbot.example.org:18990' debugPassword = 'eiv7Po'
Note carefully that the names in the
options file usually do not match
the command-line option name.
--masterfor statuslog and statusgui, this gives the location of the
--masterfor debugclient and sendchange. This option is used for two purposes. It is the location of the
debugPortfor debugclient and the location of the
pb.PBChangeSourcefor sendchange. Generally these are the same port.
XXX Must match the value of
c['debugPassword'], used to protect the
debug port, for the debugclient command.
--usernamefor the sendchange command.
--branchfor the sendchange command.
--categoryfor the sendchange command.
--connect, this specifies how the try command should deliver its request to the buildmaster. The currently accepted values are “ssh” and “pb”.
--builders, specifies which builders should be used for the try build.
--vcfor try, this specifies the version control system being used.
--branch, this indicates that the current tree is on a non-trunk branch.
try_topdir, equivalent to
--try-topdir, to explicitly indicate the top of your working tree, or
try_topfile, equivalent to
--try-topfileto name a file that will only be found in that top-most directory.
try_connectis “ssh”, the command will use
--trydir. Apologies for the confusing presence and absence of 'try'.
try_connectis “pb”, the command will pay attention to
master, respectively) are used to ask the try command to wait for the requested build to complete.