https://github.com/fnichol/chef-rbenv_system_pkgs
Chef cookbook which installs pre-built rbenv Ruby version tarballs in a system install. Works with chef-ruby_build and chef-rbenv.
https://github.com/fnichol/chef-rbenv_system_pkgs
Last synced: 2 months ago
JSON representation
Chef cookbook which installs pre-built rbenv Ruby version tarballs in a system install. Works with chef-ruby_build and chef-rbenv.
- Host: GitHub
- URL: https://github.com/fnichol/chef-rbenv_system_pkgs
- Owner: fnichol
- Created: 2012-05-05T02:52:44.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2012-06-01T04:29:35.000Z (about 13 years ago)
- Last Synced: 2025-04-10T09:57:03.164Z (2 months ago)
- Language: Ruby
- Homepage: http://fnichol.github.com/chef-rbenv_system_pkgs/
- Size: 116 KB
- Stars: 9
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# chef-rbenv_system_pkgs [](http://travis-ci.org/fnichol/chef-rbenv_system_pkgs)
Installs pre-built [rbenv][rbenv_site] Ruby version tarballs in a system
install. It does this by subscribing to an rbenv post-init hook resource in
the [rbenv][rbenv_cb] cookbook and extracting the tarball packages into the
`versions/` directory before rbenv tries to build any Ruby versions. With
the directory pre-existing a source compile will not be initiated. This
cookbook only supports rbenv installed system-wide because the install path
is known and likely to not break (since the build target path and extraction
path match).
Include `recipe[rbenv_system_pkgs]` in your run\_list and override the defaults
you want changed. See [below](#attributes) for more details.
**Note** if you use the default tarball package location frequently, please
consider making a local or alternative mirror.
## Hosting Your Own Tarball Repo
You can mirror some or all of the tarball pacakges on your own webserver by
placing all tarball packages directly under the `root_url` attribute URL.
## Creating Your Own Tarball Pacakges
You can use the [ruby_build][ruby_build_cb] and [rbenv][rbenv_cb] cookbooks
to compile your desired Ruby versions into a system-wide installation. Next
create a tarball of the directory under the `versions/` directory. For example:
cd /usr/loca/rbenv/versions
tar cpf $tarball_name.tar 1.9.3-p194
gzip -9 $tarball_name.tar
The tarball package name is of the following form:
rbenv-system----.tar.gz
Where:
* `` is the lowercase operating system name such as **ubuntu**. This
is the value of `node['platform']` in ohai.
* `` is the version number of the operating system release
such as **10.04**. This is the value of `node['platform_version']` in ohai.
* `` is the name of the Ruby version directory that will be
extracted such as **1.9.3-p194**.
* `` is the machine's architecture such as **x86_64**. This is the value
of `node['kernel']['machine']` in ohai.
For example, the following are valid tarball package filenames:
* `rbenv-system-ubuntu-10.04-1.9.3-p194-x86_64.tar.gz`
* `rbenv-system-ubuntu-10.10-ree-1.8.7-2012.02-i686.tar.gz`
* `rbenv-system-ubuntu-11.10-jruby-1.7.0-dev-x86_64.tar.gz`
Check out the [rbenvinator][rbenvinator] project as a way to automate
package building across multiple platoforms.
Tested on 0.10.8 but newer and older version should work just
fine. 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 (10.04/10.10/11.04/11.10)
Please [report][issues] any additional platforms so they can be added.
This cookbook depends on the following external cookbooks:
* [ruby_build][ruby_build_cb]
* [rbenv][rbenv_cb]
* [ark][ark_cb]
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.
[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:
gem install librarian
cd chef-repo
librarian-chef init
To reference the Git version:
cat >> Cheffile < 'https://github.com/fnichol/chef-rbenv_system_pkgs', :ref => 'v0.1.0'
END_OF_CHEFFILE
librarian-chef install
### Using knife-github-cookbooks
The [knife-github-cookbooks][kgc] gem is a plugin for *knife* that supports
installing cookbooks directly from a GitHub repository. To install with the
plugin:
gem install knife-github-cookbooks
cd chef-repo
knife cookbook github install fnichol/chef-rbenv_system_pkgs/v0.1.0
If the cookbook needs to downloaded temporarily just to be uploaded to a Chef
Server or Opscode Hosted Chef, then a tarball installation might fit the bill:
cd chef-repo/cookbooks
curl -Ls https://github.com/fnichol/chef-rbenv_system_pkgs/tarball/v0.1.0 | tar xfz - && \
mv fnichol-chef-rbenv_system_pkgs-* rbenv_system_pkgs
A dated practice (which is discouraged) is to add cookbooks as Git
submodules. This is accomplishes like so:
cd chef-repo
git submodule add git://github.com/fnichol/chef-rbenv_system_pkgs.git cookbooks/rbenv_system_pkgs
git submodule init && git submodule update
**Note:** the head of development will be linked here, not a tagged release.
### From the Opscode Community Platform
This cookbook is not currently available on the site as it relies on a
cookbook ([rbenv][rbenv_cb]) not available on the community site.
Downloads and extracts each Ruby tarball if it exists under the
[root_url](#attributes-root-url).
Use this recipe if you hate waiting for your Ruby version to build.
The base URL from which all tarball packages are available.
The default is `"http://s3.amazonaws.com/rbenv-system-pkgs"`.
The resource which occurs after rbenv is installed and intitialized. This
resource will be subscribed to, ensuring that tarball packages are installed
**before** a source compile is attempted.
The default is `"log[rbenv-post-init-system]"`.
There are **no** resources and providers in this cookbook.
* Source hosted at [GitHub][repo]
* Report issues/Questions/Feature requests on [GitHub Issues][issues]
Pull requests are very welcome! Make sure your patches are well tested.
Ideally create a topic branch for every separate change you make.
Author:: Fletcher Nichol ()
Copyright 2012, Fletcher Nichol
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
http://www.apache.org/licenses/LICENSE-2.0
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.
[ark_cb]: http://community.opscode.com/cookbooks/ark
[chef_repo]: https://github.com/opscode/chef-repo
[cheffile]: https://github.com/applicationsonline/librarian/blob/master/lib/librarian/chef/templates/Cheffile
[java_cb]: http://community.opscode.com/cookbooks/java
[gem_package_options]: http://wiki.opscode.com/display/chef/Resources#Resources-GemPackageOptions
[jruby]: http://jruby.org/
[kgc]: https://github.com/websterclay/knife-github-cookbooks#readme
[librarian]: https://github.com/applicationsonline/librarian#readme
[rbenv_cb]: http://fnichol.github.com/chef-rbenv
[rbenv_site]: https://github.com/sstephenson/rbenv
[rbenvinator]: http://fnichol.github.com/rbenvinator/
[ruby_build_cb]: http://fnichol.github.com/chef-ruby_build
[repo]: https://github.com/fnichol/chef-rbenv_system_pkgs
[issues]: https://github.com/fnichol/chef-rbenv_system_pkgs/issues