bundler – Manage Ruby Gem dependencies with Bundler
bundler – Manage Ruby Gem dependencies with Bundler
Synopsis
- Manage installation and Gem version dependencies for Ruby using the Bundler gem
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
binstub_directory - |
Only applies if state is | |
chdir - |
Default: "temporary working directory" |
The directory to execute the bundler commands from. This directory needs to contain a valid Gemfile or .bundle/ directory |
clean boolean |
|
Only applies if state is |
deployment_mode boolean |
|
Only applies if state is |
exclude_groups - |
A list of Gemfile groups to exclude during operations. This only applies when state is | |
executable - |
The path to the bundler executable | |
extra_args - |
A space separated string of additional commands that can be applied to the Bundler command. Refer to the Bundler documentation for more information | |
gem_path - |
Default: "RubyGems gem paths" |
Only applies if state is |
gemfile - |
Default: "Gemfile in current directory" |
Only applies if state is |
local boolean |
|
If set only installs gems from the cache on the target host |
state - |
|
The desired state of the Gem bundle. |
user_install boolean |
|
Only applies if state is |
Examples
# Installs gems from a Gemfile in the current directory
- bundler:
state: present
executable: ~/.rvm/gems/2.1.5/bin/bundle
# Excludes the production group from installing
- bundler:
state: present
exclude_groups: production
# Install gems into ./vendor/bundle
- bundler:
state: present
deployment_mode: yes
# Installs gems using a Gemfile in another directory
- bundler:
state: present
gemfile: ../rails_project/Gemfile
# Updates Gemfile in another directory
- bundler:
state: latest
chdir: ~/rails_project
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Tim Hoiberg (@thoiberg)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/bundler_module.html