Specify the branches if you'd like to track a specific branch in a repository. If left blank, all branches will be examined for changes and built.
The safest way is to use the refs/heads/<branchName>
syntax. This way the expected branch
is unambiguous.
If your branch name has a /
in it make sure to use the full reference above. When not presented
with a full path the plugin will only use the part of the string right of the last slash.
Meaning foo/bar
will actually match bar
.
If you use a wildcard branch specifier, with a slash (e.g. release/
),
you'll need to specify the origin repository in the branch names to
make sure changes are picked up. So e.g. origin/release/
Possible options:
<branchName>
refs/heads/<branchName>
.master
, feature1
, ...
refs/heads/<branchName>
refs/heads/master
, refs/heads/feature1/master
, ...
<remoteRepoName>/<branchName>
refs/heads/<branchName>
.origin/master
remotes/<remoteRepoName>/<branchName>
remotes/origin/master
refs/remotes/<remoteRepoName>/<branchName>
refs/remotes/origin/master
<tagName>
refs/tags/<tagName>
instead.git-2.3.0
refs/tags/<tagName>
refs/tags/git-2.3.0
<commitId>
5062ac843f2b947733e6a3b105977056821bd352
, 5062ac84
, ...
${ENV_VARIABLE}
${TREEISH}
, refs/tags/${TAGNAME}
, ...
<Wildcards>
REPOSITORYNAME/BRANCH
.
In addition, BRANCH
is recognized as a shorthand of */BRANCH
, '*' is recognized as a wildcard,
and '**' is recognized as wildcard that includes the separator '/'. Therefore, origin/branches*
would
match origin/branches-foo
but not origin/branches/foo
, while origin/branches**
would
match both origin/branches-foo
and origin/branches/foo
.
:<regular expression>
:regexp
.
Regular expression syntax in branches to build will only
build those branches whose names match the regular
expression.:^(?!(origin/prefix)).*
origin
or origin/master
or origin/feature
origin/prefix
or origin/prefix_123
or origin/prefix-abc
:origin/release-\d{8}
origin/release-20150101
origin/release-2015010
or origin/release-201501011
or origin/release-20150101-something
:^(?!origin/master$|origin/develop$).*
origin/branch1
or origin/branch-2
or origin/master123
or origin/develop-123
origin/master
or origin/develop