RailsInstaller

Rails development environment installer for Windows.

Overview

The goal of this project is to generate an installer that when run installs all of the most common components for a Rails development environment with no required prerequisites on a Windows system.

How to Contribute

RailsInstaller project code repository is located on GitHub and is bootstrapped, built and packaged via rake tasks.

1. Download and install the latest RailsInstaller.

2. Download and install latest Inno Setup Quick Start Pack, ensure iscc.exe is in your PATH.

3. Fork the RailsInstaller project on github into your own github account.

4. Open the RailsInstaller Command prompt from the start menu RailsInstaller group and change directories to where you like to keep your projects.

5. Clone your fork of the project.

   git clone [email protected]:{{your github user name}}/railsinstaller-windows

   cd railsinstaller-windows

6. Update from origin master branch and checkout a new topic branch for your feature/bugfix.

   git checkout master

   git pull origin master

   git checkout -b mybranchname

7. Bootstrap the project. From the project root run:

   rake bootstrap

8. Implement your new feature and/or fix your bug in your newly forked Railsinstaller project code.

• The configuration file for specifying required packages can be found at config/railsinstaller.yml.

• Building of the installer into the stage path for packaging is implemented by Ruby code in the lib/ directory, starting with the file lib/railsinstaller/actions.rb.

• Methods called by the actions.rb file are implemented by lib/railsinstaller/methods.rb.

1. Next build all components onto the stage (into the stage/ directory).

   rake build

2. We are now ready to use Inno Setup to package the installer into an executable (.exe) for testing/distribution.

   rake package

• This creates the executable (.exe) package file in the pkg/ directory from the files staged during the build process in the stage/ directory.

• NOTE - You can run the package task with --trace for debugging output if the package fails to build or if you simply want to see what is being done as it is done).

1. Once you have verified your new feature/bug-fix, push your branch up to GitHub.

   git commit -a -m "Implemented featureX/bugfixX which ..."

   git push origin mybranchname

2. Now issue a pull request on GitHub.

RailsInstaller Components

The next few sections detail the core components that make up RailsInstaller.

Ruby 1.9.2 on Windows

RubyInstaller is a self contained package installer which installs Ruby and RubyGems on a windows system, head over to http://rubyinstaller.org/ for more information.

Git

The git version that is bundled into RailsInstaller is msysgit.

Packaging/Installer

We are using Inno Setup, a free installer for Windows programs.