https://github.com/geerlingguy/ansible-role-ruby
Ansible Role - Ruby
https://github.com/geerlingguy/ansible-role-ruby
ansible gem installs-ruby language playbook role ruby ruby-installation
Last synced: 10 days ago
JSON representation
Ansible Role - Ruby
- Host: GitHub
- URL: https://github.com/geerlingguy/ansible-role-ruby
- Owner: geerlingguy
- License: mit
- Created: 2014-03-07T14:34:16.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2025-01-31T03:25:45.000Z (2 months ago)
- Last Synced: 2025-03-28T12:05:52.078Z (17 days ago)
- Topics: ansible, gem, installs-ruby, language, playbook, role, ruby, ruby-installation
- Language: Shell
- Homepage: https://galaxy.ansible.com/geerlingguy/ruby/
- Size: 87.9 KB
- Stars: 91
- Watchers: 2
- Forks: 88
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-ansible-roles - geerlingguy.ruby - Installs Ruby and bundler gem on Linux. (Ansible roles / Languages)
- awesome-list-ansible - ansible-role-ruby - Ruby (ruby)
README
# Ansible Role: Ruby
[](https://github.com/geerlingguy/ansible-role-ruby/actions/workflows/ci.yml)
Installs Ruby and bundler gem on Linux.
## Requirements
None.
## Role Variables
Available variables are listed below, along with default values (see `defaults/main.yml`):
workspace: /root
The location where temporary files will be downloaded in preparation for Ruby installation.
ruby_install_bundler: true
Whether this role should install [Bundler](http://bundler.io/).
ruby_install_gems: []
A list of Ruby gems to install (just the name of the gem to be installed). This is meant as a simple convenience, and will only install the latest version of the gem. If you need to install gems with more options or specificity, you can do so elsewhere in your playbook.
You can also use a dictionary for each gem that allows setting the `version` and
`user_install` keys for the `gem` Ansible module. For example:
ruby_install_gems:
- name: bundler
version: '< 2'
user_install: false
You can mix the two syntaxes, using either a dict or a string (the gem name) for each gem.
ruby_install_gems_user: username
The user account under which Ruby gems will be installed. Defaults to the `ansible_ssh_user` if not set.
ruby_install_from_source: false
By default, this role will install whatever version of ruby is available through your system's package manager (`apt` or `yum`). You can install whatever version you like (including the latest release) by setting this to `true` and/or updating the `ruby_download_url` and `ruby_version`.
ruby_download_url: http://cache.ruby-lang.org/pub/ruby/3.0/ruby-3.0.0.tar.gz
The URL from which Ruby will be downloaded (only used if `ruby_install_from_source` is `true`).
ruby_version: 3.0.0
The version of ruby that will be installed (only used if `ruby_install_from_source` is `true`).
ruby_source_configure_command: ./configure --enable-shared
The `configure` command that will be run (only used if `ruby_install_from_source` is `true`).
ruby_rubygems_package_name: rubygems
The name of the `rubygems` package. Generally, the default should work; but it will be set to `rubygems-integration` automatically on Ubuntu Trusty (14.04).
## Dependencies
None.
## Example Playbook
- hosts: server
roles:
- role: geerlingguy.ruby
## License
MIT / BSD
## Author Information
This role was created in 2014 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).