https://github.com/sous-chefs/rvm
Development repository for the rvm cookbook
https://github.com/sous-chefs/rvm
chef chef-cookbook chef-resource hacktoberfest managed-by-terraform rvm
Last synced: 5 months ago
JSON representation
Development repository for the rvm cookbook
- Host: GitHub
- URL: https://github.com/sous-chefs/rvm
- Owner: sous-chefs
- License: apache-2.0
- Created: 2010-10-13T04:43:25.000Z (almost 15 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T09:14:37.000Z (over 1 year ago)
- Last Synced: 2024-05-22T10:36:52.443Z (over 1 year ago)
- Topics: chef, chef-cookbook, chef-resource, hacktoberfest, managed-by-terraform, rvm
- Language: Ruby
- Homepage: https://supermarket.chef.io/cookbooks/rvm
- Size: 659 KB
- Stars: 516
- Watchers: 27
- Forks: 375
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# RVM
chef-rvm [](http://travis-ci.org/martinisoft/chef-rvm)
**WARNING** - Please read!
There is currently a _major_ rewrite going on with this cookbook to simplify
the interface to RVM with Chef. Expect the master branch to be very broken
until there is a 1.0 release. All previous pull requests will need to rebase
to the newer master to contribute to the newly re-factored resources.
Manages system-wide and per-user [RVM][rvm]s and manages installed Rubies.
Several resources are defined to accomplish these tasks.
Tested on 12.5.1 but older versions of chef may not work due to the changes
in the resource model. You are welcome to submit a pull request to add this
support.
File an [issue][issues] if this isn't the case.
The following platforms have been tested with this cookbook, meaning that
the recipes and LWRPs run on these platforms without error:
* ubuntu (12.04 and higher)
* debian (6.0 and newer)
* mac_os_x (10.6/10.7) (See [Platform Notes](#platform-notes-osx))
* mac_os_x_server (See [Platform Notes](#platform-notes-osx))
* suse (openSUSE, SLES)
* centos
* amazon (2011.09)
* scientific
* redhat
* fedora
* gentoo
Please [report][issues] any additional platforms so they can be added.
### Platform Notes
This cookbook suggests the [homebrew](http://community.opscode.com/cookbooks/homebrew) cookbook, which is needed to install
any additional packages needed to compile ruby. RVM now ships binary rubies,
but will require homebrew to install any additional libraries.
If you are installing [JRuby][jruby] then a Java runtime will need to be
installed. The Opscode [java cookbook][java_cb] can be used on supported
platforms.
Depending on the situation and use case there are several ways to install
this cookbook. All the methods listed below assume a tagged version release
is the target, but omit the tags to get the head of development. A valid
Chef repository structure like the [Opscode repo][chef_repo] is also assumed.
[Berkshelf][berkshelf] is a way to manage a cookbook or an application's
cookbook dependencies. Include the cookbook in your Berksfile, and then run
`berks install`. To install using Berkshelf:
```shell
gem install berkshelf
cd chef-repo
berks init
echo "cookbook 'rvm', github: 'fnichol/chef-rvm'" >> Berksfile
berks install
```
[Librarian-Chef][librarian] is a bundler for your Chef cookbooks.
Include a reference to the cookbook in a [Cheffile][cheffile] and run
`librarian-chef install`. To install Librarian-Chef:
```shell
gem install librarian-chef
cd chef-repo
librarian-chef init
cat >> Cheffile < 'git://github.com/fnichol/chef-rvm.git', :ref => 'v0.10.1'
END_OF_CHEFFILE
librarian-chef install
```
Installs the RVM gem and initializes Chef to use the Resources in this cookbook
for installing and managing RVM.
See the CONTRIBUTING.md file
### Testing
Make sure you have the following requirements setup:
* [Vagrant][vagrant]
* [vagrant-berkshelf][vagrant-berkshelf]
After you `bundle install` run `rake` for unit tests and `kitchen test` for
integration level tests.
Authors:: [Aaron Kalin][martinisoft] ()
Contributors::
Copyright:: 2010 - 2017, Aaron Kalin
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
[berkshelf]: http://berkshelf.com
[chef_repo]: https://github.com/chef/chef
[cheffile]: https://github.com/applicationsonline/librarian/blob/master/lib/librarian/chef/templates/Cheffile
[martinisoft]: https://github.com/martinisoft
[java_cb]: http://supermarket.chef.io/cookbooks/java
[jruby]: http://jruby.org/
[librarian]: https://github.com/applicationsonline/librarian#readme
[rvm]: https://rvm.io
[vagrant]: http://vagrantup.com
[vagrant-berkshelf]: https://github.com/berkshelf/vagrant-berkshelf
[issues]: https://github.com/sous-chefs/chef-rvm/issues