{"id":15415922,"url":"https://github.com/tombruijn/chef-ruby-install","last_synced_at":"2025-04-19T14:24:09.831Z","repository":{"id":12340995,"uuid":"14983217","full_name":"tombruijn/chef-ruby-install","owner":"tombruijn","description":"Cookbook to install postmodern's ruby-install and optionally Ruby versions.","archived":false,"fork":false,"pushed_at":"2015-04-15T11:49:01.000Z","size":238,"stargazers_count":7,"open_issues_count":2,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-11T15:04:36.802Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tombruijn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-06T13:17:25.000Z","updated_at":"2019-08-13T15:31:26.000Z","dependencies_parsed_at":"2022-09-19T07:31:04.803Z","dependency_job_id":null,"html_url":"https://github.com/tombruijn/chef-ruby-install","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tombruijn%2Fchef-ruby-install","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tombruijn%2Fchef-ruby-install/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tombruijn%2Fchef-ruby-install/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tombruijn%2Fchef-ruby-install/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tombruijn","download_url":"https://codeload.github.com/tombruijn/chef-ruby-install/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249712020,"owners_count":21314345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-01T17:10:13.715Z","updated_at":"2025-04-19T14:24:09.813Z","avatar_url":"https://github.com/tombruijn.png","language":"Ruby","readme":"# ruby-install Chef cookbook\n\nInstalls postmodern's [ruby-install](https://github.com/postmodern/ruby-install)\nand optionally Ruby versions.\n\n## Dependencies\n\n- git\n\n## Recipes\n\n### ruby-install::default\n\nThis default recipe will install ruby-install.\nUsing the `git_url` attribute it will download a Git repository.\nThe `git_ref` will allow you to select a version.\nPlease select one of the tags from the\n[original repository](https://github.com/postmodern/ruby-install/releases).\n\n### ruby-install::install\n\nThis recipe will also use ruby-install to install rubies.\nOne or more can be specified using the attributes.\n\nThe same can be accomplished by using the `ruby_install_ruby` provider\n(which this recipe uses).\n\n*The `ruby_install_ruby` provider accepts more\nconfigurable options than the recipe does, so if you need any of them;\nuse the provider. More information in the providers section.*\n\n## Attributes\n\nAll attributes are scoped within the `ruby-install` node attribute.\nSee also example below.\n\n- `git_url` - String - Optional -\n  Default: `https://github.com/postmodern/ruby-install.git`\n- `git_ref` - String - Optional - Default: `v0.4.3`\n- `install_path` - String - Optional -\n  Defaults to: `/var/chef/cache/ruby-install`  \n  Path to install `ruby-install` in.  \n  (*Default value uses the `file_cache_path` attribute from Chef's config.*)\n- `rubies` - Array - Default: []  \n  Each array element is a Hash with the following attributes:\n  - `ruby` - String - Required - `ruby-install` specific Ruby version\n    selector.  \n    Examples: `ruby`, `ruby 2.0.0-p353` or `rubinius stable`.  \n    *Keywords such as `stable` are supported but not recommended. See\n    `ruby_install_ruby` provider for more information.*\n  - `user` - String - Optional - User for which to install the Ruby version.  \n    If used, make sure that the user is allowed to write in the default\n    directories, if you use them, and if the user is allowed to allow\n    `ruby-install` to install packages.\n  - `group` - String - Optional - Group for which to install the Ruby version.\n  - `reinstall` - Boolean - Optional - Default: `false`  \n    Set to `true` to reinstall the ruby.\n  - `md5` - String - Optional  \n     MD5 checksum of the Ruby archive.\n  - `sha1` - String - Optional  \n    SHA1 checksum of the Ruby archive.\n  - `sha256` - String - Optional  \n    SHA256 checksum of the Ruby archive.\n  - `sha512` - String - Optional  \n    SHA512 checksum of the Ruby archive.\n  - `gems` - Array - Optional - Default: `[]`  \n    Each array element is a Hash with the following attributes:\n    - `name` - Required - Name of the gem to install.\n    - `version` - Optional - Version of the gem to install.\n    - Other gem install options are not supported by chef's `gem_package`.\n\nExample:\n\n```ruby\n{\n  \"ruby-install\" =\u003e {\n    git_url: \"https://github.com/postmodern/ruby-install.git\",\n    git_ref: \"v0.4.3\",\n    install_path: \"/home/vagrant/ruby-install\",\n    rubies: [\n      {\n        ruby: \"ruby 2.0.0-p451\",\n        user: \"vagrant\",\n        group: \"vagrant\",\n        reinstall: true,\n        gems: [\n          { name: \"bundler\", version: \"1.5.1\" }\n        ]\n      }\n    ]\n  }\n}\n```\n\n## Resources and Providers\n\n### ruby_install_ruby\n\nThis provider installs rubies using ruby-install.\n\n#### Actions\n\n##### Install\n\nInstalls the Ruby specified using ruby-install.\n\n##### Reinstall\n\nTells ruby-install to reinstall the ruby.\n\n#### Attributes\n\n- `ruby` - String - ruby-install specific Ruby version selector.  \n  Examples: `ruby`, `ruby 2.0.0-p353` or `rubinius 2.1.1`.  \n  *Keywords such as stable are not recommended as their actual version change\n  with each release.*\n- `gems` - Array - List of gems to install.  \n  Each array element is a hash that specify which gems to install.\n  See the `ruby-install::install` recipe for the format of each hash.\n- `user` - String - User for which to install the Ruby version.\n- `group` - String - Group for which to install the Ruby version.\n- `environment` - Hash - environment variables to be set.\n\nThe following are `ruby-install` specific options. If no value is specified\nit will use the `ruby-install default`.  \nHowever, `src_dir` and `install_dir` are the only two exceptions to this.\nSee the exceptions heading under the list.\n\n- `src_dir` - String - Optional  \n  Directory to download source-code into.\n- `install_dir` - String - Optional  \n  Directory to install Ruby into.\n- `patch` - String - Optional  \n  Patch to apply to the Ruby source-code.\n- `mirror` - String - Optional  \n  Alternate mirror to download the Ruby archive from.\n- `url` - String - Optional  \n  Alternate URL to download the Ruby archive from.\n- `md5` - String - Optional  \n  MD5 checksum of the Ruby archive.\n- `sha1` - String - Optional  \n  SHA1 checksum of the Ruby archive.\n- `sha256` - String - Optional  \n  SHA256 checksum of the Ruby archive.\n- `sha512` - String - Optional  \n  SHA512 checksum of the Ruby archive.\n- `no_download` - Boolean - Optional - Default `false`  \n  Use the previously downloaded Ruby archive\n- `no_verify` - Boolean - Optional - Default `false`  \n  Do not verify the downloaded Ruby archive\n- `no_install_deps` - Boolean - Optional - Default `false`  \n  Do not install build dependencies before installing Ruby\n- `no_reinstall` - Boolean - Optional - Default `false`  \n  Skip installation if another Ruby is detected in same location.\n\nExceptions:\n\n- `src_dir` is set the the users home dir `$HOME/rubies-src` if `user` is\n  specified.\n- `install_dir` is always set so that the provider can call it to install\n  gems and update the path if specified. It will default to\n  `$HOME/.rubies/$RUBY` for a user install and `/opt/rubies/$RUBY` for a\n  system install. `$RUBY` is the ruby string you specified with the spaces\n  ` ` replaced with dashes `-`.\n\n## Development\n\nIssue reports and pull requests are appreciated on\n[GitHub](https://github.com/tombruijn/chef-ruby-install).\n\n### Releases\n\nNew releases are released with the [emeril](https://github.com/fnichol/emeril)\ngem on the Opscode\n[Community site](http://community.opscode.com/cookbooks/ruby-install).\n\n## License\n\nThis cookbook is released under the MIT License.\nSee the bundled LICENSE file for details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftombruijn%2Fchef-ruby-install","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftombruijn%2Fchef-ruby-install","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftombruijn%2Fchef-ruby-install/lists"}