Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea
build
parameterFinder-agent
parameterFinder-common
parameterFinder-server
.gitignore
LICENSE
README.md
parameterFinder.iml
pom.xml
teamcity-plugin.xml

README.md

Accusoft Teamcity Plugin

Purpose

  • This plug-in's purpose is to search for user defined tools and make agent parameters for them.

  • For example, if you want to know which versions of Maven you have on a build machine, you might specify the following parameters for the plugin:

    • tool: Maven
    • regex: "Maven ([\d.]+)"
    • location: "C:\Program Files\Maven"
    • file: "mvn.cmd"
    • command: "-version"

    The tool is the name of the tool that is being searched for.

    The regex is the regular expression to extract the version number from the command output.

    The location is the base dir to search, for example, if you specify "C:\Program Files\Java", the plug-in will recursively search all subdirectories for multiple versions of Java. For example, if there was a location: "C:\Program Files\Java\jdk1.6" and "C:\Program Files\Java\jdk1.7", it would search both locations for a "java.exe" file to find both versions and add both parameters to the build agent. If you leave this value blank, or "null", the program assumes that you only want to run a command. This means that the program will NOT create a TC agent parameter for the Tool_Path, only for the version number of the tool. If you want to create a parameter for the path, you MUST specify the location to look and a file to look for.

    The file is the name of the file to search for. This value is also to be left blank or "null" if the intention is to run a command only and not search for the files on the file system.

    The command is the command to run to find the version number. This will be added to the file to make the complete command "mvn.cmd -version" unless the file/location is null in the parameters.xml file.

How to edit parameters

  • To edit which tools are searched for or edit any of the above parameters, you can edit the parameters.xml file in the location:

    • TEAMCITY_DATA_DIRECTORY\plugins\parameterFinder.zip\server\parameterFinder-server-1.0-SNAPSHOT.jar\buildServerResources\parameters.xml
  • You will then need to save the file and update the JAR file (this is done automatically with a tool like 7ZIP).

  • After this file has been modified, you need to restart the build agents that you want to pick up the edited parameters and they will create the new parameters automatically.

How to build locally

  • Clone repository to local machine and navigate to the base directory of the project and run "mvn package". This will create a ZIP file in the "base/target/" directory that you drop into the server plugins folder.
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.