A set of Meta-runners for TeamCity
PowerShell Batchfile
Latest commit e65a764 Oct 26, 2016 @pavelsher pavelsher committed on GitHub Merge pull request #87 from wes-novack/patch-1
Fix typo
Permalink
Failed to load latest commit information.
add-build-tags Trim leading and trailing whitespace from tags Oct 20, 2016
artifacts-publisher single readme Jun 27, 2013
bitbucketreleasenotes Added BitBucket Release Notes runner to be used with the same Generat… Feb 16, 2015
build-status-text build status text meta runner Dec 19, 2013
chutzpah First cut Chutzpah runner. Working locally in our TeamCity instance. May 29, 2015
create-file create text file runner Jul 31, 2013
custom-build fix processing of new lines Sep 3, 2013
deploy-war Deploy war meta-runner Jul 11, 2013
dotnet Cleans NuGet v2 cache (%LOCALAPPDATA%\NuGet\Cache) Jul 22, 2015
download-file Do not delete the target directory, delete its content instead. Apr 24, 2014
ftp-upload Added " to runnerArgs for "Upload to FTP". This fix the problem … Jun 21, 2015
gerrit-verify Fix successful build detection Aug 28, 2013
githubreleasenotes Simplified GitReleaseNotes arguments to those only relevant to GitHub… Feb 16, 2015
gitversion Replaced choco update with choco upgrade to avoid deprecation warning. May 25, 2016
jirareleasenotes Added JIRA Release Notes runner to be used with the same GenerateGitR… Feb 16, 2015
msbuild-sq-runner defaults to x86 Nov 2, 2015
nuget bitness fix Oct 14, 2013
php value of phpunit.result.error can not be changed if phpunit fails, be… Aug 24, 2015
psbuild added PSBuild meta-runner Dec 10, 2013
psget fixed error with bitness Oct 14, 2013
saltstack Fix typo Sep 29, 2016
semver-buildnumber PS script uses .NET 4 features, so requires Powershell 3.0 Nov 29, 2013
sonar-runner Escaping for analisys mode property description Jul 17, 2013
vstest Meta runner for vstest+dotCover Jan 28, 2014
xUnit.net-dotCover Merge pull request #81 from georgiosd/patch-1 Oct 21, 2016
xunit.net Update xunit.net readme for Chocolatey version compatibility. May 29, 2015
LICENSE meta runner for triggering custom build with parameters Jun 30, 2013
README.md minor text and links fixes Aug 24, 2016

README.md

Meta-runner Power Pack

A collection of Meta-runners for TeamCity.

Available Meta-Runners

  • Publish TeamCity artifacts (publishes artifacts to TeamCity while the build is running)
  • Upload to FTP (uploads files to FTP)
  • Download File (downloads file by HTTP or FTP URL)
  • Trigger Custom Build (triggers a build in TeamCity optionally with custom parameters)
  • Add Tags to Build (adds tags to currently running build in TeamCity)
  • Deploy War (deploys war file to servlet container)
  • Create Text File (creates text file with specified content)
  • Build Status Text (sets custom build status text to the build)
  • Sonar Runner (Runner for Sonar)
  • PHP-related meta runners (see documentation)
    • Run arbitrary PHP code
    • Install a specific Composer dependency
    • Install/update packages from composer.json
    • Run Phing build script
    • Run PHPUnit tests (with code coverage reporting)
  • .NET-related meta runners
    • Update connection string in configuration file
    • Update appsetting value in configuration file
    • Run tests with VSTest
  • .NET/PowerShell-based meta-runners

Installation Instructions

Each file called MRPP_<some text>.xml contains a definition of a single Meta-runner.

You can install a meta-runner directly via the file system or, since TeamCity 9.0, using the TeamCity Web UI:

  • to install Meta-runner directly to the file system, take the Meta-runner definition file and put it into the <TeamCity Data Directory>/config/projects/<Project ID>/pluginData/metaRunners/ directory, where <Project ID> is the identifier of a project where you want to place the Meta-runner. If the metaRunners directory does not exist, it will be created. Once you place the file on the disk, TeamCity will detect it and load this Meta-runner; no server restart is required.

  • to install Meta-runner via the Web UI, go to the Project Settings page, select Meta-Runners from the list of settings on the left, click Upload Meta-Runner and select the Meta-runner definition file. Save you changes.

If the Meta-runner is loaded successfully, you will see it listed on the Meta-Runners page for the project; if you have appropriate permissions, you can modify the definition directly in the TeamCity UI.

The runner is now available in the list of build runners on the build configuration Build Steps page and is represented as a native TeamCity runner with a convenient UI.

A Meta-runner placed into some project will be available to all build configurations and all subprojects of this project. If you want a Meta-runner to be available to all of the projects, place it in the Root project.

Troubleshooting

If you see "Meta-Runner with specified name already exists" when attempting to upload a meta-runner via the UI, or if after placing the Meta-runner on the disk you see the following error in the TeamCity web interface: Meta-Runner with id '<some id>' was registered from path '<some path>\<meta runner file name>.xml' and cannot be overridden from path '<another path>\<meta runner file name>.xml'

it means that a Meta-runner with the same ID is already defined in another project. To fix it, you can either remove the old Meta-runner, or change the ID of the new one. The ID of the Meta-runner is the name of the file, so you can simply rename the file. It makes sense to preserve prefix MRPP_ so that you could understand where this Meta-runner came from.

License

Apache License 2.0