rbenv
========

Role for installing [rbenv](https://github.com/sstephenson/rbenv).

Role ready status
------------

[![Build Status](https://travis-ci.org/zzet/ansible-rbenv-role.png?branch=master)](https://travis-ci.org/zzet/ansible-rbenv-role)

Requirements
------------

none

Role Variables
--------------

Default variables are:

    rbenv:
      env: system
      version: v0.4.0
      ruby_version: 2.2.3

    rbenv_repo: "https://github.com/sstephenson/rbenv.git"

    rbenv_plugins:
      - { name: "rbenv-vars",
          repo: "https://github.com/sstephenson/rbenv-vars.git",
          version: "v1.2.0" }

      - { name: "ruby-build",
          repo: "https://github.com/sstephenson/ruby-build.git",
          version: "v20151028" }

      - { name: "rbenv-default-gems",
          repo: "https://github.com/sstephenson/rbenv-default-gems.git",
          version: "v1.0.0" }

      - { name: "rbenv-installer",
          repo: "https://github.com/fesplugas/rbenv-installer.git",
          version: "8bb9d34d01f78bd22e461038e887d6171706e1ba" }

      - { name: "rbenv-update",
          repo: "https://github.com/rkh/rbenv-update.git",
          version: "32218db487dca7084f0e1954d613927a74bc6f2d" }

      - { name: "rbenv-whatis",
          repo: "https://github.com/rkh/rbenv-whatis.git",
          version: "v1.0.0" }

      - { name: "rbenv-use",
          repo: "https://github.com/rkh/rbenv-use.git",
          version: "v1.0.0" }

    rbenv_root: "{% if rbenv.env == 'system' %}/usr/local/rbenv{% else %}$HOME/.rbenv{% endif %}"

    rbenv_users: []

Description:

- ` rbenv.env ` - Type of rbenv installation. Allows 'system' or 'user' values
- ` rbenv.version ` - Version of rbenv to install (tag from [rbenv releases page](https://github.com/sstephenson/rbenv/releases))
- ` rbenv.ruby_version ` - Version of ruby to install as global rbenv ruby
- ` rbenv_repo ` - Repository with source code of rbenv to install
- ` rbenv_plugins ` - Array of Hashes with information about plugins to install
- ` rbenv_root ` - Install path
- ` rbenv_users ` - Array of usernames for multiuser install. User must be present in the system
- ` default_gems_file ` - This is Rbenv's plugin _rbenv-default-gems_. Sets the path to a default-gems file of your choice (_don't set it_ if you want to use the default file `files/default-gems`)

Example:

    - hosts: web
      vars:
        rbenv:
          env: user
          version: v0.4.0
          ruby_version: 2.0.0-p353
      roles:
        - role: zzet.rbenv
          rbenv_users:
            - user

Dependencies
------------

none

License
-------

MIT

Author Information
------------------

[Andrew Kumanyaev](http://github.com/zzet)

[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/zzet/ansible-rbenv-role/trend.png)](https://bitdeli.com/free "Bitdeli Badge")