Why did my TeamCity build stop working?

Question

I have a TeamCity build configuration that has been working fine until recently. Suddenly, there is a build stuck in the queue that says it is not compatible with any agents. The reason given is:

Implicit requirements: teamcity.build.branch defined in Parameter: BuildFormatSpecification

My BuildFormatSpecification parameter is defined thus:

%MajorVersion%.%MinorVersion%.%PatchVersion%-%teamcity.build.branch%

That in turn is used in the Build Number Format field along with a build counter, like this:

%BuildFormatSpecification%.%sharedBuildNumber.id4%

The idea is that the build number comes out like "1.0.0-develop.22" and includes the Git branch being built. This follows the rules for Semantic Versioning. This scheme has worked for me over a number of projects, but suddenly this one build is stuck and I can't figure out why.

Any ideas?

Solution

teamcity.build.branch is a predefined build parameter but it is only defined when a branch specification is configured. Therefore, to fix your problem, make sure that your build step has a VCS root configured and add e.g. +:refs/heads/(master) as your branch specification.

From TeamCity's documentation on Agent Requirements and implicit requirements:

Any reference (name in %-signs) to an unknown parameter is considered an "implicit requirement". That means that the build will only run on the agent which provides the parameters named.

Otherwise, the parameter should be made available for the build configuration by defining it on the build configuration or project levels.

Comments

[Traderhut Games]

Also, Team City doesn't clear the problem once you fix it, you have to delete the build request and re-add it back. Nice. At least, on the version I'm using, which is a few builds back. Ironically, if you set a default branch (required), and then leave the branch specification blank (shouldn't be required, as their description of it is: "Branches to monitor besides the default one " - which is 'none' just monitor the default one. Also, if you switch from a single line here, to two full specifications, your branch displayed changes from 'develop' to /ref/head/develop' which

[Traderhut Games]

wastes space on the description,and adds junk to the build name - and was causing my builds to fail due to the name... No clue how to fix that..

[Johan Boberg]

You should ask a new question about branch names but the answer is to use parentheses around the part you want to be displayed, in my example it will be "master". See jetbrains.com/help/teamcity/….