RORIIS Wiki & Documentation Rss Feed

Updated Wiki: Home

bheinz — Thu, 09 Aug 2012 00:40:48 GMT

The Ruby on Rails (ROR) framework is typically run under Apache on both Linux and Windows Systems. For those that do not wish to use Apache to host their solutions on windows, one alternative is running under Internet Information Services (IIS) World Wide Web Publishing (W3SVC) service.

The installer packages Shane Careveo's Fast-CGI ISAPI filter, Ionic's Rewrite ISAPI filter, SQL Server support for rails and my IIS configuration scripts to allow for seamless integration of your Ruby On Rails web application with Microsoft's IIS web server on Windows XP or Windows Server 2003 (32-bit and 64-bit).

This is the most complete solution for hosting your Ruby Rails application under IIS.

The installer is compiled using the Nullsoft Installer System (NSIS). IIS setup is handled by my jscript file which leverages the ADSI API and is executed from the installer. It installs the Rewrite filter, FCGI filter (including registry config settings), Ruby FCGI bindings and configures the IIS website.

Questions or comments? Please use the discussions.

News:
8/8/2012 - That didn't pan out. This project hasn't been worked on in several years. If you haven't considered it yet, please take a look at hosting in the cloud with my friends from Tier 3 who built .net support into VMWare's Cloud Foundry. Their project can be found over at Iron Foundry. They support .net + anything supported by Cloud Foundry, including Ruby On Rails.
Cinco De Mayo 2010 - Sounds like a friend of mine may be taking over this project... finally! If anyone can rate the release that would be great. It has been over 2 years since last code change, does this even still work?
21 Jul 2008 - Looking for a volunteer to take over this project for me.
04 Jun 2007 - Making Rails HTTP Status codes return properly to IIS clients.
20 Feb 2007 - Version 1.0.5 has been released!
As always, feedback is appreciated!

Important Please Read This: You must override the ActionController AbstractRequest class's request_uri method, otherwise your application will not work properly! If you run the installer, you can also find the documentation in the IIS_Configuration.html under the installation path/documentation. I am also adding it here for a quick reference: Documentation For Modifying The request_uri Method.

Maybe some day: Documentation or support for setting up multiple rails apps side-by-side.

Documentation:
Required Procedure: Documentation For Modifying The request_uri Method
Rails bug Fix: Making Rails HTTP Status codes return properly to IIS clients.
Documentation for Manually Configuring IIS Fast-CGI For Ruby On Rails (work in progress)
Documentation and sample files for Ruby Test Integration With CruiseControl.net

Links:
Tier 3 - Enterprise Cloud
Iron Foundry - open PAAS for .net

used by this project
Ruby on Rails
Ionic's Isapi Rewrite for IIS
Shane Careveo's FCGI ISAPI Filter

Updated Wiki: Home

bheinz — Thu, 09 Aug 2012 00:31:47 GMT

The Ruby on Rails (ROR) framework is typically run under Apache on both Linux and Windows Systems. For those that do not wish to use Apache to host their solutions on windows, one alternative is running under Internet Information Services (IIS) World Wide Web Publishing (W3SVC) service.

The installer packages Shane Careveo's Fast-CGI ISAPI filter, Ionic's Rewrite ISAPI filter, SQL Server support for rails and my IIS configuration scripts to allow for seamless integration of your Ruby On Rails web application with Microsoft's IIS web server on Windows XP or Windows Server 2003 (32-bit and 64-bit).

This is the most complete solution for hosting your Ruby Rails application under IIS.

The installer is compiled using the Nullsoft Installer System (NSIS). IIS setup is handled by my jscript file which leverages the ADSI API and is executed from the installer. It installs the Rewrite filter, FCGI filter (including registry config settings), Ruby FCGI bindings and configures the IIS website.

Questions or comments? Please use the discussions.

News:
8/8/2012 - That didn't pan out. This project hasn't been worked on in several years. If you haven't considered it yet, please take a look at hosting in the cloud with my friends from http://tier3.com who built .net support into VMWare's http://CloudFoundry.org. Their project can be found over at http://IronFoundry.org. They support .net + anything supported by Cloud Foundry, including Ruby On Rails.
Cinco De Mayo 2010 - Sounds like a friend of mine may be taking over this project... finally! If anyone can rate the release that would be great. It has been over 2 years since last code change, does this even still work?
21 Jul 2008 - Looking for a volunteer to take over this project for me.
04 Jun 2007 - Making Rails HTTP Status codes return properly to IIS clients.
20 Feb 2007 - Version 1.0.5 has been released!
As always, feedback is appreciated!

Important Please Read This: You must override the ActionController AbstractRequest class's request_uri method, otherwise your application will not work properly! If you run the installer, you can also find the documentation in the IIS_Configuration.html under the installation path/documentation. I am also adding it here for a quick reference: Documentation For Modifying The request_uri Method.

Maybe some day: Documentation or support for setting up multiple rails apps side-by-side.

Documentation:
Required Procedure: Documentation For Modifying The request_uri Method
Rails bug Fix: Making Rails HTTP Status codes return properly to IIS clients.
Documentation for Manually Configuring IIS Fast-CGI For Ruby On Rails (work in progress)
Documentation and sample files for Ruby Test Integration With CruiseControl.net

Links:
Ruby on Rails
Ionic's Isapi Rewrite for IIS (used by this project)
Shane Careveo's

Updated Wiki: Home

bheinz — Wed, 05 May 2010 20:11:58 GMT

The Ruby on Rails (ROR) framework is typically run under Apache on both Linux and Windows Systems. For those that do not wish to use Apache to host their solutions on windows, one alternative is running under Internet Information Services (IIS) World Wide Web Publishing (W3SVC) service.

The installer packages Shane Careveo's Fast-CGI ISAPI filter, Ionic's Rewrite ISAPI filter, SQL Server support for rails and my IIS configuration scripts to allow for seamless integration of your Ruby On Rails web application with Microsoft's IIS web server on Windows XP or Windows Server 2003 (32-bit and 64-bit).

This is the most complete solution for hosting your Ruby Rails application under IIS.

The installer is compiled using the Nullsoft Installer System (NSIS). IIS setup is handled by my jscript file which leverages the ADSI API and is executed from the installer. It installs the Rewrite filter, FCGI filter (including registry config settings), Ruby FCGI bindings and configures the IIS website.

Questions or comments? Please use the discussions.

News:
Cinco De Mayo 2010 - Sounds like a friend of mine may be taking over this project... finally! If anyone can rate the release that would be great. It has been over 2 years since last code change, does this even still work?
21 Jul 2008 - Looking for a volunteer to take over this project for me.
04 Jun 2007 - Making Rails HTTP Status codes return properly to IIS clients.
20 Feb 2007 - Version 1.0.5 has been released!
As always, feedback is appreciated!

Important Please Read This: You must override the ActionController AbstractRequest class's request_uri method, otherwise your application will not work properly! If you run the installer, you can also find the documentation in the IIS_Configuration.html under the installation path/documentation. I am also adding it here for a quick reference: Documentation For Modifying The request_uri Method.

Maybe some day: Documentation or support for setting up multiple rails apps side-by-side.

Documentation:
Required Procedure: Documentation For Modifying The request_uri Method
Rails bug Fix: Making Rails HTTP Status codes return properly to IIS clients.
Documentation for Manually Configuring IIS Fast-CGI For Ruby On Rails (work in progress)
Documentation and sample files for Ruby Test Integration With CruiseControl.net

Links:
Ruby on Rails
Ionic's Isapi Rewrite for IIS (used by this project)
Shane Careveo's

Updated Wiki: Home

bheinz — Wed, 05 May 2010 20:11:10 GMT

The Ruby on Rails (ROR) framework is typically run under Apache on both Linux and Windows Systems. For those that do not wish to use Apache to host their solutions on windows, one alternative is running under Internet Information Services (IIS) World Wide Web Publishing (W3SVC) service.

The installer packages Shane Careveo's Fast-CGI ISAPI filter, Ionic's Rewrite ISAPI filter, SQL Server support for rails and my IIS configuration scripts to allow for seamless integration of your Ruby On Rails web application with Microsoft's IIS web server on Windows XP or Windows Server 2003 (32-bit and 64-bit).

This is the most complete solution for hosting your Ruby Rails application under IIS.

The installer is compiled using the Nullsoft Installer System (NSIS). IIS setup is handled by my jscript file which leverages the ADSI API and is executed from the installer. It installs the Rewrite filter, FCGI filter (including registry config settings), Ruby FCGI bindings and configures the IIS website.

Questions or comments? Please use the discussions.

News:
Cinco De Mayo 2010 - Sounds like a friend of mine may be taking over this project... finally! If anyone can rate the release that would be great. It has been nearly 2 years since last code change, does this even still work?
21 Jul 2008 - Looking for a volunteer to take over this project for me.
04 Jun 2007 - Making Rails HTTP Status codes return properly to IIS clients.
20 Feb 2007 - Version 1.0.5 has been released!
As always, feedback is appreciated!

Important Please Read This: You must override the ActionController AbstractRequest class's request_uri method, otherwise your application will not work properly! If you run the installer, you can also find the documentation in the IIS_Configuration.html under the installation path/documentation. I am also adding it here for a quick reference: Documentation For Modifying The request_uri Method.

Maybe some day: Documentation or support for setting up multiple rails apps side-by-side.

Documentation:
Required Procedure: Documentation For Modifying The request_uri Method
Rails bug Fix: Making Rails HTTP Status codes return properly to IIS clients.
Documentation for Manually Configuring IIS Fast-CGI For Ruby On Rails (work in progress)
Documentation and sample files for Ruby Test Integration With CruiseControl.net

Links:
Ruby on Rails
Ionic's Isapi Rewrite for IIS (used by this project)
Shane Careveo's

Updated Wiki: Home

bheinz — Mon, 21 Jul 2008 15:38:35 GMT

The Ruby on Rails (ROR) framework is typically run under Apache on both Linux and Windows Systems. For those that do not wish to use Apache to host their solutions on windows, one alternative is running under Internet Information Services (IIS) World Wide Web Publishing (W3SVC) service.

The installer packages Shane Careveo's Fast-CGI ISAPI filter, Ionic's Rewrite ISAPI filter, SQL Server support for rails and my IIS configuration scripts to allow for seamless integration of your Ruby On Rails web application with Microsoft's IIS web server on Windows XP or Windows Server 2003 (32-bit and 64-bit).

This is the most complete solution for hosting your Ruby Rails application under IIS.

The installer is compiled using the Nullsoft Installer System (NSIS). IIS setup is handled by my jscript file which leverages the ADSI API and is executed from the installer. It installs the Rewrite filter, FCGI filter (including registry config settings), Ruby FCGI bindings and configures the IIS website.

Questions or comments? Please use the discussions.

News:
21 Jul 2008 - Looking for a volunteer to take over this project for me.
04 Jun 2007 - Making Rails HTTP Status codes return properly to IIS clients.
20 Feb 2007 - Version 1.0.5 has been released!
As always, feedback is appreciated!

Important Please Read This: You must override the ActionController AbstractRequest class's request_uri method, otherwise your application will not work properly! If you run the installer, you can also find the documentation in the IIS_Configuration.html under the installation path/documentation. I am also adding it here for a quick reference: Documentation For Modifying The request_uri Method.

Coming soon: Documentation for setting up multiple rails apps side-by-side.

Documentation:
Required Procedure: Documentation For Modifying The request_uri Method
Rails bug Fix: Making Rails HTTP Status codes return properly to IIS clients.
Documentation for Manually Configuring IIS Fast-CGI For Ruby On Rails (work in progress)
Documentation and sample files for Ruby Test Integration With CruiseControl.net

Links:
Ruby on Rails
Ionic's Isapi Rewrite for IIS (used by this project)
Shane Careveo's

UPDATED WIKI: Home

bheinz — Thu, 20 Sep 2007 23:36:04 GMT

The Ruby on Rails (ROR) framework is typically run under Apache on both Linux and Windows Systems. For those that do not wish to use Apache to host their solutions on windows, one alternative is running under Internet Information Services (IIS) World Wide Web Publishing (W3SVC) service.

The installer packages Shane Careveo's Fast-CGI ISAPI filter, Ionic's Rewrite ISAPI filter, SQL Server support for rails and my IIS configuration scripts to allow for seamless integration of your Ruby On Rails web application with Microsoft's IIS web server on Windows XP or Windows Server 2003 (32-bit and 64-bit).

This is the most complete solution for hosting your Ruby Rails application under IIS.

The installer is compiled using the Nullsoft Installer System (NSIS). IIS setup is handled by my jscript file which leverages the ADSI API and is executed from the installer. It installs the Rewrite filter, FCGI filter (including registry config settings), Ruby FCGI bindings and configures the IIS website.

Questions or comments? Please use the discussions.

News:
04 Jun 2007 - Making Rails HTTP Status codes return properly to IIS clients.
20 Feb 2007 - Version 1.0.5 has been released!
As always, feedback is appreciated!

Important Please Read This: You must override the ActionController AbstractRequest class's request_uri method, otherwise your application will not work properly! If you run the installer, you can also find the documentation in the IIS_Configuration.html under the installation path/documentation. I am also adding it here for a quick reference: Documentation For Modifying The request_uri Method.

Coming soon: Documentation for setting up multiple rails apps side-by-side.

Documentation:
Required Procedure: Documentation For Modifying The request_uri Method
Rails bug Fix: Making Rails HTTP Status codes return properly to IIS clients.
Documentation for Manually Configuring IIS Fast-CGI For Ruby On Rails (work in progress)
Documentation and sample files for Ruby Test Integration With CruiseControl.net

Links:
Ruby on Rails
Ionic's Isapi Rewrite for IIS (used by this project)
Shane Careveo's

UPDATED WIKI: Making Rails HTTP Status codes return properly to IIS clients

bheinz — Mon, 04 Jun 2007 22:21:55 GMT

The default implementation of the render_text method improperly sets @response.headers['Status'] uppercase. The reason it works under webrick is because webrick does a downcase when you access or mutate the headers[key.downcase] hash where the Rails CgiResponse class does not. The Ruby CGI class checks @headers['status'] lowercase and thus fails to pass the proper status on the HTTP/1.x #{status_code} #{status_reason} header line.

The following procedure will allow your rails application to pass the correct HTTP status codes back to your clients through IIS:

Create a new file called #{RAILS_ROOT}/lib/action_controller_base_ext.rb.
Edit the new file, paste in the following code and save it.

module ActionController
  class Base
    def render_text(text = nil, status = nil)
      @performed_render = true
      @response.headers['status'] = (status || DEFAULT_RENDER_STATUS_CODE).to_s
      @response.body = text
    end
  end
end

Edit your #{RAILS_ROOT}/config/environment.rb file and append the following snippet to ensure your application uses the new render_text method instead of the default one.

# Include your app's configuration here:
require 'action_controller_base_ext.rb'

UPDATED WIKI: Making Rails HTTP Status codes return properly to IIS clients

bheinz — Mon, 04 Jun 2007 22:20:26 GMT

The following procedure will allow your rails application to pass the correct HTTP status codes back to your clients through IIS:

Create a new file called #{RAILS_ROOT}/lib/action_controller_base_ext.rb.
Edit the new file, paste in the following code and save it.

module ActionController
  class Base
    def render_text(text = nil, status = nil)
      @performed_render = true
      @response.headers['status'] = (status || DEFAULT_RENDER_STATUS_CODE).to_s
      @response.body = text
    end
  end
end

Edit your #{RAILS_ROOT}/config/environment.rb file and append the following snippet to ensure your application uses the new render_text method instead of the default one that improperly sets @response.headers['Status'] uppercase. The reason it works under webrick is because webrick does a downcase when you access or mutate the headers[key.downcase] hash where the Rails CgiResponse class does not. The Ruby CGI class checks @headers['status'] lowercase and thus fails to pass the proper status on the HTTP/1.x #{status_code} #{status_reason} header line.

# Include your app's configuration here:
require 'action_controller_base_ext.rb'

UPDATED WIKI: Making Rails HTTP Status codes return properly to IIS clients

bheinz — Mon, 04 Jun 2007 22:10:10 GMT

Create a new file called #{RAILS_ROOT}/lib/action_controller_base_ext.rb.
Edit the new file, paste in the following code and save it.

module ActionController
  class Base
    def render_text(text = nil, status = nil)
      @performed_render = true
      @response.headers['status'] = (status || DEFAULT_RENDER_STATUS_CODE).to_s
      @response.body = text
    end
  end
end

Add a reference to this new file in your #{RAILS_ROOT}/config/Environment.rb.

UPDATED WIKI: Home

bheinz — Mon, 04 Jun 2007 22:07:09 GMT

The Ruby on Rails (ROR) framework is typically run under Apache on both Linux and Windows Systems. For those that do not wish to use Apache to host their solutions on windows, one alternative is running under Internet Information Services (IIS) World Wide Web Publishing (W3SVC) service.

The installer packages Shane Careveo's Fast-CGI ISAPI filter, Ionic's Rewrite ISAPI filter, SQL Server support for rails and my IIS configuration scripts to allow for seamless integration of your Ruby On Rails web application with Microsoft's IIS web server on Windows XP or Windows Server 2003 (32-bit and 64-bit).

This is the most complete solution for hosting your Ruby Rails application under IIS.

The installer is compiled using the Nullsoft Installer System (NSIS). IIS setup is handled by my jscript file which leverages the ADSI API and is executed from the installer. It installs the Rewrite filter, FCGI filter (including registry config settings), Ruby FCGI bindings and configures the IIS website.

Questions or comments? Please use the forums...

News:
04 Jun 2007 - Making Rails HTTP Status codes return properly to IIS clients.
20 Feb 2007 - Version 1.0.5 has been released!
As always, feedback is appreciated!

Important Please Read This: You must override the ActionController AbstractRequest class's request_uri method, otherwise your application will not work properly! If you run the installer, you can also find the documentation in the IIS_Configuration.html under the installation path/documentation. I am also adding it here for a quick reference: Documentation For Modifying The request_uri Method.

Coming soon: Documentation for setting up multiple rails apps side-by-side.

Documentation:
Required Procedure: Documentation For Modifying The request_uri Method
Rails bug Fix: Making Rails HTTP Status codes return properly to IIS clients.
Documentation for Manually Configuring IIS Fast-CGI For Ruby On Rails (work in progress)
Documentation and sample files for Ruby Test Integration With CruiseControl.net

Links:
Ruby on Rails
Ionic's Isapi Rewrite for IIS (used by this project)
Shane Careveo's

UPDATED WIKI: Home

bheinz — Mon, 04 Jun 2007 22:06:16 GMT

The Ruby on Rails (ROR) framework is typically run under Apache on both Linux and Windows Systems. For those that do not wish to use Apache to host their solutions on windows, one alternative is running under Internet Information Services (IIS) World Wide Web Publishing (W3SVC) service.

The installer packages Shane Careveo's Fast-CGI ISAPI filter, Ionic's Rewrite ISAPI filter, SQL Server support for rails and my IIS configuration scripts to allow for seamless integration of your Ruby On Rails web application with Microsoft's IIS web server on Windows XP or Windows Server 2003 (32-bit and 64-bit).

This is the most complete solution for hosting your Ruby Rails application under IIS.

The installer is compiled using the Nullsoft Installer System (NSIS). IIS setup is handled by my jscript file which leverages the ADSI API and is executed from the installer. It installs the Rewrite filter, FCGI filter (including registry config settings), Ruby FCGI bindings and configures the IIS website.

Questions or comments? Please use the forums...

News:
04 Jun 2007 - Making rails HTTP Status codes return properly to IIS clients.
20 Feb 2007 - Version 1.0.5 has been released!
As always, feedback is appreciated!

Important Please Read This: You must override the ActionController AbstractRequest class's request_uri method, otherwise your application will not work properly! If you run the installer, you can also find the documentation in the IIS_Configuration.html under the installation path/documentation. I am also adding it here for a quick reference: Documentation For Modifying The request_uri Method.

Coming soon: Documentation for setting up multiple rails apps side-by-side.

Documentation:
Required Procedure: Documentation For Modifying The request_uri Method
Documentation for Manually Configuring IIS Fast-CGI For Ruby On Rails (work in progress)
Documentation and sample files for Ruby Test Integration With CruiseControl.net

Links:
Ruby on Rails
Ionic's Isapi Rewrite for IIS (used by this project)
Shane Careveo's

UPDATED WIKI: Ruby Test Integration With CruiseControl.net

bheinz — Thu, 15 Mar 2007 20:37:53 GMT

Ruby Test Integration With CruiseControl.net

Please use the thread Integrating Ruby On Rails Unit Tests in CruiseControl.net for posting comments about this procedure.

In order to integrate your ruby on rails unit tests into your CruiseControl build process so you can see the test results in the webdashboard, you must peform the following tasks in order:

Installing Test-Report:

Download and extract the contents of the test-report-0.3.0.zip (looks like the rubyforge project vaporized so I uploaded a copy that I had) Version 0.3.0 distribution.
Open the folder where you saved the test-report code.
Modify the /lib/test/unit/ui/reporter.rb, and add the following snippet just beneath the other 'require' declarations.

require 'test/unit/ui/console/testrunner'

Open a command prompt in the test-report root directory.
Execute > ruby.exe setup.rb config

This command configures the test-report addin to work with your installation of Ruby.

Execute > ruby.exe setup.rb install

This command adds the test-report files to your ruby library.

Setting up WebDashboard:

Download rubyunittests.xsl and save it to your CruiseControl.NET/webdashboard/xsl/ folder.
Now you must change your CruiseControl.NET/webdashboard/dashboard.config file so it will show a new RUnit Details report in the Dashboard's left navigation.
Open the dashboard.config file and modify it by adding your own "xsl report build plugin".

<!-- Example From File: /CruiseControl.NET/webdashboard/dashboard.config -->
<dashboard>
    <plugins>
        <buildPlugins>
            <!-- This is where you insert the following line -->
            <xslReportBuildPlugin description="RUnit Details" actionName="RunitBuildReport" 
                xslFileName="xsl\rubyunittests.xsl />
        </buildPlugins>
    </plugins>
</dashboard>

Configuring Your tests.rb File:

Download tests.rb and save it to the root of your Ruby On Rails application.
The tests.rb sample file assumes a pattern of /tests/unit/*/_test.rb, you will need to change this pattern or add your own methods for adding functional tests or other tests directories you wish to generate results for.
Don't forget to modify the tests.rb file for your specific database configuration, specifically the createDatabase method. This example file assumes SQL Server 2005.
Note: To configure different databases, look at the Ruby Active Record source code located in your c:/ruby/lib/ruby/gems/1.8/gems/activerecord-x.x.x/lib/activerecord/connectionadapters/. Specifically, look at the adapter_name property for the connection adapter your application requires.

Setting up Your Build Script:

Add a build task in your build.myproject.xml MSBuild script file as show below, this will execute the unit tests.

<!-- Run Ruby Unit Tests -->
<Target Name="run-tests">
    <Exec ContinueOnError="false" Command="c:\ruby\bin\ruby.exe tests.rb"
        WorkingDirectory="c:\projects\myrailsapp\">
	<Output TaskParameter="ExitCode" ItemName="ExitCodes"/>
    </Exec>
    <Error Text="One or more Unit Tests failed." Condition="'%(ExitCodes.Identity)'>0"/>
</Target>

In the build script for your project, add a file merge publisher. This will merge your unit test output details into the cruise control build log for your project.
Note: You can change the name of the output results xml file by changing the name of your TestSuite class's constructor where it calls the base class's initialize('MyRailsApp') argument, located in tests.rb.

<project>
     <!-- Some Build Script Settings -->
     <publishers>
         <merge>
	     <files>
                 <file>C:\Projects\MyRailsApp\TestResults\TEST-MyRailsApp.xml</file>
             </files>
         </merge>
     </publishers>
     <!-- Some Other Build Script Settings -->
</project>

Files:
tests.rb
runit.xsl
test-report-0.3.0.zip (added local copy because rubyforge site is gone!)

Links:
Test-Report Version 0.3.0 - http://test-report.rubyforge.org (site is down or does not exist anymore)
Throughworks CruiseControl.Net - http://cruisecontrol.confluence.net

UPDATED WIKI: Ruby Test Integration With CruiseControl.net

bheinz — Thu, 15 Mar 2007 18:19:22 GMT

Ruby Test Integration With CruiseControl.net

Download and extract the contents of the test-report-0.3.0.zip (looks like the rubyforge project vaporized so I uploaded a copy that I had) Version 0.3.0 distribution.
Open the folder where you saved the test-report code.
Modify the /lib/test/unit/ui/reporter.rb, and add the following snippet just beneath the other 'require' declarations.

require 'test/unit/ui/console/testrunner'

Open a command prompt in the test-report root directory.
Execute > ruby.exe setup.rb config

This command configures the test-report addin to work with your installation of Ruby.

Execute > ruby.exe setup.rb install

This command adds the test-report files to your ruby library.

Setting up WebDashboard:

Download rubyunittests.xsl and save it to your CruiseControl.NET/webdashboard/xsl/ folder.
Now you must change your CruiseControl.NET/webdashboard/dashboard.config file so it will show a new RUnit Details report in the Dashboard's left navigation.
Open the dashboard.config file and modify it by adding your own "xsl report build plugin".

<!-- Example From File: /CruiseControl.NET/webdashboard/dashboard.config -->
<dashboard>
    <plugins>
        <buildPlugins>
            <!-- This is where you insert the following line -->
            <xslReportBuildPlugin description="RUnit Details" actionName="RunitBuildReport" 
                xslFileName="xsl\rubyunittests.xsl />
        </buildPlugins>
    </plugins>
</dashboard>

Configuring Your tests.rb File:

Download tests.rb and save it to the root of your Ruby On Rails application.
The tests.rb sample file assumes a pattern of /tests/unit/*/_test.rb, you will need to change this pattern or add your own methods for adding functional tests or other tests directories you wish to generate results for.
Don't forget to modify the tests.rb file for your specific database configuration, specifically the createDatabase method. This example file assumes SQL Server 2005.
Note: To configure different databases, look at the Ruby Active Record source code located in your c:/ruby/lib/ruby/gems/1.8/gems/activerecord-x.x.x/lib/activerecord/connectionadapters/. Specifically, look at the adapter_name property for the connection adapter your application requires.

Setting up Your Build Script:

Add a build task in your build.myproject.xml MSBuild script file as show below, this will execute the unit tests.

<!-- Run Ruby Unit Tests -->
<Target Name="run-tests">
    <Exec ContinueOnError="false" Command="c:\ruby\bin\ruby.exe tests.rb"
        WorkingDirectory="c:\projects\myrailsapp\">
	<Output TaskParameter="ExitCode" ItemName="ExitCodes"/>
    </Exec>
    <Error Text="One or more Unit Tests failed." Condition="'%(ExitCodes.Identity)'>0"/>
</Target>

In the build script for your project, add a file merge publisher. This will merge your unit test output details into the cruise control build log for your project.
Note: You can change the name of the output results xml file by changing the name of your TestSuite class's constructor where it calls the base class's initialize('MyRailsApp') argument, located in tests.rb.

<project>
     <!-- Some Build Script Settings -->
     <publishers>
         <merge>
	     <files>
                 <file>C:\Projects\MyRailsApp\TestResults\TEST-MyRailsApp.xml</file>
             </files>
         </merge>
     </publishers>
     <!-- Some Other Build Script Settings -->
</project>

Files:
tests.rb
runit.xsl
test-report-0.3.0.zip

Links:
Test-Report Version 0.3.0 - http://test-report.rubyforge.org
Throughworks CruiseControl.Net - http://cruisecontrol.confluence.net

UPDATED WIKI: Home

bheinz — Tue, 20 Feb 2007 15:44:02 GMT

UPDATED WIKI: Documentation For Modifying The request_uri Method

bheinz — Mon, 19 Feb 2007 22:57:58 GMT

Create a new file called #{RAILS_ROOT}/lib/action_controller_request_ext.rb.
Edit the new file, paste in the following code and save it.

module ActionController
  class AbstractRequest
    # override to fix certain ambiguities with IIS and Fast CGI and Rewrite
    def request_uri
      if uri = env['REQUEST_URI']
        (%r{^\w+\://[^/]+(/.*|$)$} =~ uri) ? $1 : uri # Remove domain, which webrick puts into the request_uri.
      else # REQUEST_URI is blank under IIS - get this from PATH_INFO and SCRIPT_NAME
        # remove the script file name (dispatch.fcgi) from the URI
        uri = env['PATH_INFO'] 
        uri = uri.sub("#{env['SCRIPT_NAME']}", "") unless env['SCRIPT_NAME'].nil?
        # replace the isapi rewrite query string with the original path and query (opnq)
        unless( opnq = env["QUERY_STRING"]).nil? || opnq.empty?
          env["QUERY_STRING"] = opnq.sub("?","&") # overwrite the invalid query string
          uri << opnq.sub("opnq=", "") # remove the "opnq=" that Rewrite put on the request_uri
        end
        uri
      end
    end
  end
end

Edit your #{RAILS_ROOT}/config/environment.rb file and append the following snippet to ensure your application uses the new request_uri method instead of the default one.

# Include your app's configuration here:
require 'action_controller_request_ext.rb'

Note: This solution was derived from some that I found on the web. There was a small issue in that if more than one query string variable is appended to a path http://localhost/mycontroller/dosomething?var1=123&var2=abc, then QUERY_STRING["var1"] = nil but QUERY_STRING["/mycontroller/dosomething?var1"] = 123 and QUERY_STRING["var2"] = abc. This is obviously a problem and others have come up with solutions similar to mine however, conforming to "proper" query string syntax, it is best if you replace the original path and query string as a variable, hence the opnq=. The only side effect (not necessarily negative) of using my solution is the fact that QUERY_STRING["opnq"] = /mycontroller/dosomething?var1=123&var2=abc and the fact that it shows up in the IIS log files under the query string column.
If you wish, you can test the request_uri extension by browsing to http://localhost/dispatch.fcgi?opnq=/mycontroller/dosomething?var1=123&var2=abc and verifying that things are working properly.

Note: Your IsapiRewite4.ini file needs to have a rewrite rule like this one:

IterationLimit 0
 
# note: does not support files (see example below)
RewriteRule ^(/[^.]+)$ /dispatch.fcgi?opnq=$1

Below you can see why the default implementation does not work together nicely with Fast-CGI and IsapiRewrite4.

Resulting Outputs:

Files:
IsapiRewrite4.ini
action_controller_request_ext.rb

UPDATED WIKI: Home

bheinz — Thu, 15 Feb 2007 04:52:18 GMT

UPDATED WIKI: Home

bheinz — Thu, 15 Feb 2007 04:42:39 GMT

UPDATED WIKI: Home

bheinz — Thu, 15 Feb 2007 04:42:07 GMT

UPDATED WIKI: Home

bheinz — Thu, 15 Feb 2007 04:41:32 GMT

UPDATED WIKI: Home

bheinz — Tue, 23 Jan 2007 00:36:19 GMT