Icon

You are viewing the documentation of TeamCity 10.x and 2017.x, which is not the most recently released version of TeamCity.
View this page in the latest documentation or refer to the listing to choose the documentation corresponding to your TeamCity version.

 

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This section details creating build configurations via the TeamCity web UI. Other options include the REST API and using TeamCity project configuration in DSL based on the Kotlin language.

TeamCity provides several ways to create a new build configuration for a project . using the Project Settings page:

 Image Added

You can :

...

create a new build configuration

...

When build configurations are created, you can:

Anchor
creatingNewBuildConfiguration
creatingNewBuildConfiguration

Creating New Build Configuration Manually

  1. On the Administration > Projects page, select the desired project in the list. (Alternatively, open the project using the Projects popup, and click the Edit Project Settings link on the right).  The Project Settings page opens.

  2.  On the Project Settings page, Build Configurations section, click Create build configuration.

  3. Specify the In the Create Build Configuration dialog, specify the name, id and (optionally) description for the build configuration, click Create.
  4. Proceed with creating other settings:

...

  1. On the Administration > Projects page, select the desired project in the list. (Alternatively, open the project using the Projects popup, and click the Edit Project Settings link on the right).  The Project Settings page opens.

  2.  On On the Project Settings page, Build Configurations section, click Create build configuration from URL.

  3. Specify In the Create Build Configuration dialog, specify a VCS repository URL and, if authentication is required, VCS credentials. click Click Create.

  4. TeamCity will suggest the build configuration name and will configure the rest of settings for you.

    • it will determine the type of the VCS repository and create a VCS root
    • TeamCity will attempt to auto-detect build steps: Ant, NAnt, Gradle, Maven, MSBuild, Visual Studio solution files, PowerShell, Xcode project files, Rake, and IntelliJ IDEA projects. If none found, you will have to configure build steps manually.
    • Next, TeamCity UI will display suggestion icons with prompts to create build triggersfailure conditions and build features. Depending on the build configuration settings, it may suggest some additional configuration options.
  5. After the build configuration is created, you can run a build and/or tweak the settings.

Creating  New Build Configuration pointing to GitHub.com repository

  1. Click the Create build configuration button and select Pointing to GitHub.com repository.
    • If you do not have a GitHub connection configured, you will be redirected to the Connections page. Set up the connection as described here, then follow the steps below.
    • If you have a GitHub connection configured, follow the steps below.
  2. On the Create  Build Configuration From GitHub page, select a repository. TeamCity will verify the repository connection. If the Connection is verified, the new page opens.
  3. TeamCity will display the project and build configuration name. If required,  modify the names and click Proceed.
  4. TeamCity will add a VCS build trigger and attempt to auto-detect build steps: Ant, NAnt, Gradle, Maven, MSBuild, Visual Studio solution files, PowerShell, Xcode project files, Rake, and IntelliJ IDEA projects.
    On the Auto-detected Build Steps page, select the step(s) to use in your build configuration. Click Use selected
    If no steps found, you will have to configure build steps manually.
  5. Your project and a build configuration are configured. Click the Run button to start the build.
    (info) Depending on the build configuration settings, TeamCity can suggest some additional configuration options. Review the suggested settings Image Added and configure required ones.

Creating  New Build Configuration pointing to Bitbucket Cloud

  1. Click the Create build configuration button and select Pointing to Bitbucket Cloud repository.
    • If you do not have a Bitbucket connection configured, you will be redirected to the Connections page. Set up the connection as described here, then follow the steps below.
    • If you have a Bitbucket connection configured, follow the steps below.
  2. On the Create  Build Configuration From Bitbucket Cloud page, select a repository. TeamCity will verify the repository connection. If the Connection is verified, the new page opens.
  3. TeamCity will display the project and build configuration name. If required,  modify the names and click Proceed.
  4. TeamCity will add a VCS build trigger and attempt to auto-detect build steps: Ant, NAnt, Gradle, Maven, MSBuild, Visual Studio solution files, PowerShell, Xcode project files, Rake, and IntelliJ IDEA projects.
    On the Auto-detected Build Steps page select the step(s) to use in your build configuration. Click Use selected
    If no steps found, you will have to configure build steps manually.
  5. Your project and a build configuration are configured. Click the Run button to start the build.
    (info) Depending on the build configuration settings, TeamCity can suggest some additional configuration options. Review the suggested settings Image Added and configure required ones.

Anchor
creatingBuildConfigurationTemplate
creatingBuildConfigurationTemplate

Creating Build Configuration Template

...

  1. Open the existing build configuration settings page, click Actions  at  at the top right corner of the screen, and select  the select the Extract Template option.
  2. Specify the settings required and click Create.

...

  1. On the Administration > Projects page, select the desired project in the list. (Alternatively, open the project using the Projects popup, and click the Edit Project Settings link on the right).  The Project Settings page opens. 
  2. On the Project Settings page, Build Configuration Templates section, locate the desired template and click its name or use Edit.
  3. Click Actions  at  at the top right corner of the screen, and select Create Build Configuration.
  4. Specify the required settings for the new configuration. 

    Note

    The settings specified in the template cannot be edited in a configuration created from this template. However, some of them can be redefined in a build configuration. Note that modifying the settings of the template itself will affect all configurations based on this template.

...

  1. On the Administration > Projects page, select the desired project in from the list. (Alternatively, open the project using the Projects popup, and click the Edit Project Settings link on the right).  The Project Settings page opens.

  2.  On the Project Settings page, Build Configurations section, click Create build configuration.

  3. On the configuration settings page, use the he the Based on template drop-down and selecting select a template for your build configuration configuration.

Ordering Build Configurations

...

Configuring settings of a build configuration is described on the following pages:

Children Display

(warning) Note that editing via the TeamCity Web UI will be disabled for build configurations created via the REST API.

See also:

Panel
bgColor#FFFFFF
borderStyledashed

Administrator's Guide: Configuring Dependencies | Configuring Build Parameters | Configuring VCS Settings