| Parameter | Choices/Defaults | Comments | 
                
                                                            | binstub_directory 
                    -
                                                                 |  | Only applies if state is present. Specifies the directory to install any gem bins files to. When executed the bin files will run within the context of the Gemfile and fail if any required gem dependencies are not installed. Ifchdiris set then this path is relative tochdir | 
                            
                                                            | 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 present. If set removes any gems on the target host that are not in the gemfile | 
                            
                                                            | deployment_mode 
                    boolean
                                                                 |  | Only applies if state is present. If set it will install gems in ./vendor/bundle instead of the default location. Requires a Gemfile.lock file to have been created prior | 
                            
                                                            | exclude_groups 
                    -
                                                                 |  | A list of Gemfile groups to exclude during operations. This only applies when state is present. Bundler considers this a 'remembered' property for the Gemfile and will automatically exclude groups in future operations even ifexclude_groupsis not set | 
                            
                                                            | 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 present. Specifies the directory to install the gems into. Ifchdiris set then this path is relative tochdir | 
                            
                                                            | gemfile 
                    -
                                                                 | Default: 
 "Gemfile in current directory" | Only applies if state is present. The path to the gemfile to use to install gems. | 
                            
                                                            | local 
                    boolean
                                                                 |  | If set only installs gems from the cache on the target host | 
                            
                                                            | state 
                    -
                                                                 | Choices:
                                                                                                                                                            present ←latest | The desired state of the Gem bundle. latestupdates gems to the most recent, acceptable version | 
                            
                                                            | user_install 
                    boolean
                                                                 |  | Only applies if state is present. Installs gems in the local user's cache or for all users |