28 April 2019
A lot of my projects depend on Ruby: from this website to iOS apps using CocoaPods. Given that projects start at different times (meaning that it can require different versions of Ruby, etc.), it’s important to know which specific Ruby version and dependencies are required. This is especially important if others need to reproduce the environment, as well.
With that said, here are a few tips….
rbenv is a tool for picking a specific Ruby version for your application.
Install a Ruby version with the following command:
# List all available versions
rbenv install -l
# Install a specific version, e.g. 2.5.3
rbenv install 2.5.3
For each project, create a .ruby-version file in the root that specifies the version you need. For example:
# Navigate to the project root
cd $PROJECT_ROOT
echo "2.5.3" > .ruby-version
rbenv takes care of Ruby versions, but what about gems? That’s where bundler comes in.
To install bundler:
gem install bundler
Specify gems in a Gemfile in the project’s root:
# Gemfile content
source 'https://rubygems.org'
gem 'github-pages', group: :jekyll_plugins
With the gems specified in a single file, the next step is to install them. The default command (bundle install) will install all the gems into the global Ruby version specified in .ruby-version. That’s fine… but there’s a better way to manage gems per project….
Add the following parameter to the bundle install command:
bundle install --path=.gems
The --path option allows you to specify where the gems should be installed. I like to install them into a hidden folder called .gems in the project root. This ensures that the gems are only visible to this project.
To ensure reproducibility, I check in the following files:
.ruby-versionGemfileGemfile.lockWhat I add to .gitignore:
.gemsThis folder can be safely ignored since everything is specified in the files above.
And, that’s it! Hope this helps the next time you set up a Ruby project!