This page describes how to configure a Bamboo MSTest Runner task. The MSTest Runner task runs and parses tests for .NET builds.
Before you begin:
- .NET builder tasks in Bamboo (e.g. NAnt) do not parse test information as part of the task. You must configure a test task (e.g. MSTest Parser), if you want test results from the builder task to be parsed.
- If Bamboo is running as a Windows service, ensure that the Service is running as a local user instead of a System User (Bamboo will install itself as the SYSTEM user on Windows).
To configure a Bamboo MSTest Runner task:
- Navigate to the Tasks configuration tab for the job (this will be the default Job if creating a new plan).
- Select the name of an existing MSTest Runner task, or select Add task > MSTest Runner to create a new task.
Update the task settings:
A description of the task, for display in Bamboo.
Disable this task
Check, or clear, to selectively run this task.
Add condition to task
Make task run only when a certain condition is met.
You can find conditions on Atlassian Marketplace or implement your own.
The MSTest Runner executable that you wish to use for this task (e.g. "Visual Studio 2010"). The executable that you select will become one of the task's capability requirements (and hence, one of the job's requirements). For details, please see Configuring a job's requirements.
Specifically for MSTest, we recommend that the executable be defined with the Visual Studio IDE folder path. Example:
C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\
This will allow Bamboo to find the necessary resources.
Any extra environment variables you want to pass to your build. e.g. JAVA_OPTS="-Xmx256m -Xms128m".
The test container, i.e. the file that contains the tests you want to run. For example,
tests.dll. The value of this field is passed to the MSTest.exe as the
/testcontainer parameter. See MSTest.exe Command-Line Options (MSDN).
The path to the Test Metadata file relative to the working directory. For example, "MyApp\MyApp.vsmdi"
The file that you want to save the test results to. For example,
testResults.trx. The value of this field is passed to the MSTest.exe as the
/resultsfile parameter. See MSTest.exe Command-Line Options (MSDN).
The run configuration that you want to use. For example,
localtestrun.Testrunconfig. The value of this field is passed to the MSTest.exe as the
/runconfig parameter. See MSTest.exe Command-Line Options (MSDN).