The Projects tab shows a list of projects and their build configurations. Build configurations can be expanded to show the status of running builds and the last completed build.
tip
Certain options will only be visible if the user has permission to use them. For example, guest users in TeamCity Professional will not see the Run button, Stop build and Configure Visible Projects links and will not be able to view web diffs of changes. The same limitations apply to users with only project viewer or agent manager roles in TeamCity Enterprise. If users in TeamCity Enterprise have been assigned project developer or project administrator roles in specific projects, then these features will be available to them on those particular projects.)
Option
Description
Configure Visible Projects
Click this link to open a popup with a list of all the projects. Select the check boxes of the projects to be displayed on the page or click and drag the button to reposition the project on the list. Click Close to save your settings and close the popup.
View all projects
Click this link to open a popup with a list of all of the projects, regardless whether they are visible or not.
Collapse all
Click this link to hide all of the build results from the page view.
Expand all
Click this link to show the status of running builds and the last completed build.
Hide project
Removes the project from the page view. Hint: Use Configure Visible Projects to restore hidden projects.
This link appears when a build is in the build queue. Click this link to navigate to the Build Queue tab.
Pending
This link appears when modifications are ready to be integrated in the next build. Click this link to navigate to the pending changes tab on the build configuration's page, or click the drop-down arrow to open a popup list of pending changes. Click the drop-down arrow to the right of a specific pending change to view a popup list of the files that were edited. Click the link to open the web diff in a separate page or click to open the file in your IDE.
Click the Run button to start a build on the next available agent.
Click the drop-down arrow on the right side of the Run button to view a drop-down list of compatible Build Agents. Use this list to select a specific agent to run the build.
Build results option
Description
Build status
The Build Configuration State are available in real time. Click this link to navigate to the Build Results page, or click the drop-down arrow just to the right of the build results to view a list of specific tabs on the Build Results page that you can navigate to directly.
Artifacts
This link appears if the build created artifacts. Follow this link to the Artifacts tab on the Build Results page, or click the drop-down arrow to the right of the link to open a popup list of artifacts and links to them.
Changes
This link appears if changes were integrated into the build. Click this link to navigate the Changes tab on the Build Results page, or click the drop-down arrow to open a popup list of changes. If the previous build failed, this popup may contain two tabs showing which changes were made In this build and Since last successful build. Click the drop-down arrow to the right of a specific change to view a popup list of the files that were edited. Click the link to view a web diff in a separate page or click to open the file in your IDE.
Build time/duration
Shows the time the build was started and the duration it took to build. If the build is currently running it will show the start time and a progress bar. The tool tip will display the build's elapsed time and an estimated amount of time it will take to finish.
Stop build
This link appears if the build is currently running. Click this link to abort the build. A comment window will appear. Comments will be visible on the Build Results page.
Enhancements in TeamCity 3.1
note
The Projects tab was improved between TeamCity 3.0 and TeamCity 3.1. The following features are only available in TeamCity 3.1.
The View All Projects link has been replaced with a drop-down arrow on the Projects tab button. This drop-down arrow will display all of the projects regardless of whether they are visible on the Projects tab or not.
The builds in-queue drop-down arrow appears on the build configuration heading and displays a popup with build queue information. Descriptions of elements on this popup can be found on the build queue section in the documentation.