4.11.3.7 Git
The Git
build step clones or updates a Git repository and checks out the specified branch or revision. Note
that the buildbot supports Git version 1.2.0 and later: earlier
versions (such as the one shipped in Ubuntu 'Dapper') do not support
the git init command that the buildbot uses.
The Git step takes the following arguments:
repourl
- (required): the URL of the upstream Git repository.
branch
- (optional): this specifies the name of the branch to use when a Build
does not provide one of its own. If this this parameter is not
specified, and the Build does not provide a branch, the “master”
branch will be used.
ignore_ignores
- (optional): when purging changes, don't use .gitignore and
.git/info/exclude.
submodules
- (optional): when initializing/updating a Git repository, this decides whether
or not buildbot should consider git submodules. Default: False.
reference
- (optional): use the specified string as a path to a reference repository on the
local machine. Git will try to grab objects from this path first instead of the
main repository, if they exist.
shallow
- (optional): instructs git to attempt shallow clones (
--depth 1
). If the
user/scheduler asks for a specific revision, this parameter is ignored.
progress
- (optional): passes the (
--progress
) flag to (git fetch
). This
solves issues of long fetches being killed due to lack of output, but requires
Git 1.7.2 or later.