TeamCity On-Premises
 
Get TeamCity On-Premises

Working with Meta-Runner

Edit pageLast modified: 21 January 2025

A meta-runner allows you to extract build steps, requirements, and parameters from a build configuration and create a build runner out of them. This build runner can then be used as any other build runner in a build step of any other build configuration or template.

With meta-runners, you can:

  • Reuse existing runners

  • Create new runners for typical tasks (for example, publish to FTP, delete a directory)

  • Simplify your build configuration and decrease a number of build steps

Basically, a meta-runner is a set of build steps from one build configuration that you can reuse in another; it is an XML definition, containing build steps, requirements, and parameters, that you can utilize in XML definitions of other build configurations.

TeamCity allows extracting meta-runners using the web UI.

All meta-runners are stored on a project level, so they are available within this project and its subprojects only, and are not visible outside. If a meta-runner is stored on the Root project level, it is available globally (in all projects).

You can use the existing meta-runners from the TeamCity Meta-Runners Power Pack or create your own meta-runner.