TeamCity On-Premises 2021.2 Help

Deployment Build Configuration

TeamCity provides the Deployment type of build configuration. Build configurations which perform deploying to some environment can be marked with this type: these are usually build configurations that have snapshot or artifact dependencies on the builds whose results they deploy.

After creating a build configuration, open its General Settings and set the Build configuration type to Deployment. The type change does not affect the build configuration functionality but offers some handy features to distinguish the deployment build from other builds.
You can change the type back to Regular anytime.

Once a configuration is marked as Deployment, TeamCity changes behavior in the following way:

  • The Run button caption for this configuration changes to Deploy.

  • If there is a build used as a dependency in a deployment configuration, then, after the build is run, its Build Results page will display the Deployments section allowing you to quickly deploy the build.

    Build deployments
  • The Change details page (the page where you can see which configurations are affected by the change and which builds have been executed with this change) has the Deployments tab that shows builds in Deployment configurations where this change was deployed for the first time.

    Deployments in Change details
  • For deployment configurations, TeamCity always shows the latest started build regardless of the changes it contains; unlike regular build configurations, for which the build with the latest changes is displayed.

  • When setting the build configuration type to Deployment, several settings are automatically changed to reflect the best practices: "Limit the number of simultaneously running builds" is set to "1" and the "Allow triggering personal builds" option is turned off.

Last modified: 26 April 2022