Build State
The build state icon appears next to each build under the expanded view of the build configuration on the Projects page.
Build States
Icon | State | Description |
---|---|---|
running successfully | A build is running successfully. | |
successful | A build finished successfully in all specified build configurations. | |
running and failing | A build is failing. | |
failed | A build failed at least in one specified build configuration. | |
cancelled | A build was cancelled. |
Canceled/Stopped build
Stopping a running build results in the build status displayed as cancelled. You can stop a running build from the Build Results, Build Configuration Home or using the Stop option from the Actions drop-down menu.
When a build is started, the build process calls the runner process and listens to its output. The stop command kills the runner process, then the build process stops.
Personal Build States
Icon | State | Description |
---|---|---|
running successfully | A personal build is running successfully. | |
successful | A personal build has completed successfully for all specified build configurations. | |
running and failing | A personal build is running with errors. | |
failed | A personal build failed at least in one specified build configuration. |
Hanging and Outdated Builds
TeamCity considers a build as hanging when its run time significantly exceeds estimated average run time and the build did not send any messages since the estimation exceeded.
A running build can be marked as Outdated if there is a build which contains more changes but it is already finished.Hanging and outdated builds appear with the icon . Move the cursor over the icon to view a tooltip that displays additional information about the warning.
Failed to Start Builds
Builds which failed to start, that is which did not get to the point of launching the first build step are marked with the icon. It may be caused by a VCS repository being down when the build starts, or the inability to resolve artifact dependencies and so on. Such build status is often an indication of a configuration error and should usually be addressed by a build engineer rather than a developer.
If such an error occurs, TeamCity:
doesn't send build failed notification (unless you have subscribed to "the build fails to start" notification)
doesn't associate pending changes with this build, that is the changes will remain pending, because they were not actually tested
doesn't show such build as the last finished build on the overview page
such builds will not affect the build configuration status and the status of developer changes
shows a "configuration error" stripe for a build configuration with such a build
Project and Build Configuration Icons
A build's success or failure affects its color and the colors of its parent configuration and project. Color-coded icons provide a bird's eye view of the build farm, enabling you to instantly spot problematic projects.
TeamCity object icons have three distinctive colors:
- Gray
Build: not yet started (queued) or cancelled.
Configuration: either the selected branch has no builds, or the default branch doesn't (for the side navigation tree and <All branches> view).
Project: neither of the project configurations have builds.
- Green
Build: successfully finished or running without any issues.
Configuration: the last build for a selected or default branch was successful.
Project: all of its configurations are green.
- Red
Build: failed or still running but encountered a problem.
Configuration: the last build for a selected or default branch failed.
Project: at least one of its configurations is red.
The following images illustrate the same configuration with builds in three different branches: "main" (default branch), "development", and "sandbox".
The last "development" branch build was successful. If this branch is selected, the configuration icon is green.
The last "sandbox" branch build failed. If this branch is selected, the configuration icon is red.
The default "main" branch has no builds, so configuration icons in both side navigation tree and <All branches> view are gray. The same "unknown" status applies to the entire project, since this is its only configuration.