Recently I had to work on a project that used VSTS unit tests and we needed to integrate the tests into our continuous integration process. We were using cruise control.NET. After doing a lot of research on the Web, I decided to write this small article since there is little information on the subject. This article assumes that you have already created a working continuous integration environment with CCNET for your Visual Studio 2008 project.
Executing the Unit Tests
You can use the command line test runner tool MSTest.exe to run your unit tests from CCNET. This requires that you install Visual Studio 2008 on the continuous integration server.
For example, the following command line can be used to execute the unit tests contained in the TestAssembly.dll and store the test results into results.xml.
One problem with
MSTest is that it complains if the results file already exists. To avoid this, you have to delete the results file before calling
MSTest. We can create a batch file in the projects working directory to do this, let’s call it RunTests.bat.
You need to replace
<PathToTestProject> with the absolute path of your unit test project and make sure the path to MSTest.exe is added to the system path. Everytime this batch file runs, it will delete the results.xml in the working directory and call
MSTest that in turn will run the tests and create a new results file.
Now we need to call this batch file from CCNET. Open your ccnet.config file and insert an
exec task just after the
msbuild task that builds your project as given below:
Including the Results in the Build Report
First we need to merge the results.xml file to the build log. To do that, update the publishers section of the ccnet.config file as given below:
To include the unit test results in the build report, we need XSL files to generate the appropriate HTML. Unfortunately the XSL files supplied with
CruiseControl as of version 126.96.36.19972 do not support the output format generated by
MSTest version 9. I have created 2 XSL files called MSTest9Report.xsl and MSTest9Summary.xsl that are available in the download. These files are based on the MSTestReport.xsl and MSTestSummary.xsl distributed with CCNET version 188.8.131.5272.
Download and copy the files to the \CruiseControl.NET\server\xsl folder and \CruiseControl.NET\webdashboard\xsl folders. Then modify the ccservice.exe.config (or ccnet.exe.config if you use ccnet.exe instead of the ccservice) file by modifying the
xslFiles section as given below:
In the above section, I have removed the unittests.xsl which is there by default and added mstest9summary.xsl instead.
Now we need to configure the Web dashboard. Open the dashboard.config file and update the
buildPlugins section as given below:
<xslReportBuildPlugin description="MSTest Report" actionName="MSTESTReport"
Again, I have removed the unittestsummary.xsl and added
mstest9summary instead. The new
xslReportBuildPlugin element causes a link to be displayed on the left side called “MSTest Report”, and when clicked it will display the detailed test results in a table.
That's it, now restart your ccservice and your VSTS unit tests should be fully integrated with cruise control. The XSL files supplied displays the Test Name, Outcome, Duration, Message and the Stack Trace but they can be easily modified to display additional information available in the test results.
- 17th April, 2008: Initial post