cookbook 'rbenv', '= 1.4.1'
rbenv
(25) Versions
1.4.1
-
Follow94
Installs and configures rbenv
cookbook 'rbenv', '= 1.4.1', :supermarket
knife supermarket install rbenv
knife supermarket download rbenv
rbenv cookbook
Installs and manages your versions of Ruby and Gems in Chef with rbenv and ruby_build
Requirements
- Chef 10
- Centos / Redhat / Fedora / Ubuntu / Debian
Usage
Add a dependency on rbenv to your cookbook's metadata.rb
depends 'rbenv'
Installing rbenv and ruby_build
To install rbenv and ruby_build; Include each recipe in one of your cookbook's recipes
include_recipe "rbenv::default"
include_recipe "rbenv::ruby_build"
Installing a Ruby
And now to install a Ruby use the rbenv_ruby LWRP
rbenv_ruby "1.9.3-p194"
Installing Gems for rbenv managed Rubies
If you'd like a specific Ruby installed by rbenv to include a Gem, say bundler, use the rbenv_gem LWRP
rbenv_gem "bundler" do
ruby_version "1.9.3-p194"
end
Be sure to include a value for the ruby_version attribute so the gem is installed for the correct Ruby
Attributes
rbenv
-
rbenv[:group_users]- Array of users belonging to the rbenv group -
rbenv[:git_repository]- Git url of the rbenv repository to clone -
rbenv[:git_revision]- Revision of the rbenv repository to checkout -
rbenv[:install_prefix]- Path prefix rbenv will be installed into
ruby_build
-
ruby_build[:git_repository]- Git url of the ruby_build repository to clone -
ruby_build[:git_revision]- Revision of the ruby_build repository to checkout -
ruby_build[:prefix]- Path prefix where ruby_build will be installed to
Recipes
default
Configures a node with a system wide rbenv accessible by users in the rbenv group
ruby_build
Installs ruby_build to a node which enables the rbenv_ruby LWRP to install Rubies to the node
ohai_plugin
Installs an rbenv Ohai plugin onto the node to automatically populate attributes about the rbenv installation
Resources / Providers
rbenv_ruby
Install specified version of Ruby to be managed by rbenv
Actions
| Action | Description | Default |
|---|---|---|
| install | Install the version of Ruby | Yes |
Attributes
| Attribute | Description | Default |
|---|---|---|
| ruby_version | the ruby version and patch level you wish to install | name |
| force | install even if this version is already present (reinstall) | false |
| global | set this ruby version as the global version | false |
Examples
Installing Ruby 1.9.2-p290
rbenv_ruby "1.9.2-p290"
Forcefully install Ruby 1.9.3-p0
rbenv_ruby "Ruby 1.9.3" do
ruby_version "1.9.3-p0"
force true
end
rbenv_gem
Install specified RubyGem for the specified ruby_version managed by rbenv
Actions
| Action | Description | Default |
|---|---|---|
| install | Install the gem | Yes |
| upgrade | Upgrade the gem to the given version | |
| remove | Remove the gem | |
| purge | Purge the gem and configuration files |
Attributes
| Attribute | Description | Default |
|---|---|---|
| package_name | Name of given to modify | name |
| ruby_version | Ruby of version the gem belongs to | |
| version | Version of the gem to modify | |
| source | Specified if you have a local .gem file to install | |
| gem_binary | Override for path to gem command | |
| response_file | ||
| options | Additional options to the underlying gem command |
Examples
Installing Bundler for Ruby 1.9.2-p290
rbenv_gem "bundler" do
ruby_version "1.9.2-p290"
end
Releasing
-
Install the prerequisite gems
$ bundle install Increment the version number in the metadata.rb file
-
Run the Thor release task to create a tag and push to the community site
$ bundle exec thor release
Authors and Contributors
- Jamie Winsor (jamie@vialstudios.com)
