ANSIBLE.GEM(3)                  ANSIBLE MODULES                 ANSIBLE.GEM(3)



NAME
       gem - Manage Ruby gems

DESCRIPTION
       Manage installation and uninstallation of Ruby gems.

OPTIONS
       executable
              Override the path to the gem executable(Added in Ansible version
              1.4.)


       gem_source
              The path to a local gem used as installation source.

       include_dependencies
              Wheter to include dependencies or not.  Choices: yes,no.
              (default: yes)

       name   The name of the gem to be managed.(required)

       repository
              The repository from which the gem will be installed

       state  The desired state of the gem. latest ensures that the latest
              version is installed.  Choices: present,absent,latest.(required)

       user_install
              Install gem in user's local gems cache or for all users
              (default: yes)(Added in Ansible version 1.3.)


       version
              Version of the gem to be installed/removed..

EXAMPLES
       # Installs version 1.0 of vagrant.
       - gem: name=vagrant version=1.0 state=present

       # Installs latest available version of rake.
       - gem: name=rake state=latest

       # Installs rake version 1.0 from a local gem on disk.
       - gem: name=rake gem_source=/path/to/gems/rake-1.0.gem state=present



AUTHOR
       Johan Wiren

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#gem



1.4.5                             2014-02-12                    ANSIBLE.GEM(3)
