https://github.com/flavorjones/windows-ruby-dev-tools-release
BOSH release to install Ruby dev tools on a Windows stemcell
https://github.com/flavorjones/windows-ruby-dev-tools-release
bosh bosh-release ruby windows
Last synced: about 1 year ago
JSON representation
BOSH release to install Ruby dev tools on a Windows stemcell
- Host: GitHub
- URL: https://github.com/flavorjones/windows-ruby-dev-tools-release
- Owner: flavorjones
- License: other
- Created: 2017-03-19T05:27:07.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-02-17T05:17:13.000Z (over 8 years ago)
- Last Synced: 2024-05-22T17:21:52.864Z (about 2 years ago)
- Topics: bosh, bosh-release, ruby, windows
- Language: PowerShell
- Homepage:
- Size: 78.1 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# windows-ruby-dev-tools-release
This is a [BOSH](https://github.com/cloudfoundry/bosh) release to
install some tools on a windows stemcell for Ruby development.
It was driven out by the desire to
use [Concourse](https://concourse.ci/) to CI
the [Nokogiri toolchain](http://status.nokogiri.org) across multiple
operating systems.
## Tools Installed
- [Ruby 2.5 with optional DevKit](https://rubyinstaller.org/)
- [Ruby 2.4 with optional DevKit](https://rubyinstaller.org/)
- [Ruby 2.3 with optional DevKit](https://rubyinstaller.org/)
- [unzip](http://gnuwin32.sourceforge.net/packages/unzip.htm)
- [patch](http://gnuwin32.sourceforge.net/packages/patch.htm)
- [Git](https://github.com/git-for-windows/git/releases)
- [gpg](https://www.gnupg.org)
- 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:
``` powershell
. "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:
``` powershell
$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:
- [x] ruby 2.5 with devkit
- [x] ruby 2.4 with devkit
- [x] ruby 2.3 with devkit
- [x] document how to choose a ruby
- [x] document how to opt into devkit
- [x] 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