windows-ruby-dev-tools-release

This is a BOSH release to install some tools on a windows stemcell for Ruby development.

It was driven out by the desire to use Concourse to CI the Nokogiri toolchain across multiple operating systems.

Tools Installed

• Ruby 2.5 with optional DevKit
• Ruby 2.4 with optional DevKit
• Ruby 2.3 with optional DevKit
• unzip
• patch
• Git
• gpg
• a prelude.ps1 file for all your powershell needs

Tools Not Yet Installed (But I Plan To Do Soon)

• CMake
• msys2

How do I use this?

prelude.ps1

This prelude file sets up some sound defaults for your powershell scripts:

• the powershell equivalent of bash's set -eux
• set up output to not have ridiculously small linewraps
• a cmdlet, system-cmd that will do what you expect with a command string

You use it by putting this line at the top of your powershell scripts:

. "c:\var\vcap\packages\windows-ruby-dev-tools\prelude.ps1"

Ruby

By default, Ruby 2.4 will be in your search path as ruby or ruby.exe, as will utilities like gem.

You can choose a different version of Ruby by setting $env:WIN_RUBY_VERSION to one of:

• 2.5
• 2.4 (default)
• 2.3

You can opt into using DevKit by adding this line to your powershell script:

$env:RUBYOPT = "-rdevkit"

Concourse support

Check out https://github.com/flavorjones/concourse-gem if you'd like to integrate your concourse pipelines with the rubies in this release.

Other executables

All the other executables are in your search path, so just go ahead and use unzip and other utilities like you normally would.

TODO

High priority:

• ruby 2.5 with devkit
• ruby 2.4 with devkit
• ruby 2.3 with devkit
• document how to choose a ruby
• document how to opt into devkit
• update concourse-gem with windows-awareness
• install msys2 into a common directory (rather than into ruby directories)
• cmake

Lower priority:

• ruby 2.2 with devkit
• ruby 2.1 with devkit