You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
203 lines
6.9 KiB
203 lines
6.9 KiB
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright (c) 2015, Tim Hoiberg <tim.hoiberg@gmail.com>
|
|
# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
__metaclass__ = type
|
|
|
|
|
|
DOCUMENTATION = r"""
|
|
module: bundler
|
|
short_description: Manage Ruby Gem dependencies with Bundler
|
|
description:
|
|
- Manage installation and Gem version dependencies for Ruby using the Bundler gem.
|
|
extends_documentation_fragment:
|
|
- community.general.attributes
|
|
attributes:
|
|
check_mode:
|
|
support: full
|
|
diff_mode:
|
|
support: none
|
|
options:
|
|
executable:
|
|
type: str
|
|
description:
|
|
- The path to the bundler executable.
|
|
state:
|
|
type: str
|
|
description:
|
|
- The desired state of the Gem bundle. V(latest) updates gems to the most recent, acceptable version.
|
|
choices: [present, latest]
|
|
default: present
|
|
chdir:
|
|
type: path
|
|
description:
|
|
- The directory to execute the bundler commands from. This directory needs to contain a valid Gemfile or .bundle/ directory.
|
|
- If not specified, it will default to the temporary working directory.
|
|
exclude_groups:
|
|
type: list
|
|
elements: str
|
|
description:
|
|
- A list of Gemfile groups to exclude during operations. This only applies when O(state=present). Bundler considers
|
|
this a 'remembered' property for the Gemfile and will automatically exclude groups in future operations even if O(exclude_groups)
|
|
is not set.
|
|
clean:
|
|
description:
|
|
- Only applies if O(state=present). If set removes any gems on the target host that are not in the gemfile.
|
|
type: bool
|
|
default: false
|
|
gemfile:
|
|
type: path
|
|
description:
|
|
- Only applies if O(state=present). The path to the gemfile to use to install gems.
|
|
- If not specified it will default to the Gemfile in current directory.
|
|
local:
|
|
description:
|
|
- If set only installs gems from the cache on the target host.
|
|
type: bool
|
|
default: false
|
|
deployment_mode:
|
|
description:
|
|
- Only applies if O(state=present). If set it will install gems in C(./vendor/bundle) instead of the default location.
|
|
Requires a C(Gemfile.lock) file to have been created prior.
|
|
type: bool
|
|
default: false
|
|
user_install:
|
|
description:
|
|
- Only applies if O(state=present). Installs gems in the local user's cache or for all users.
|
|
type: bool
|
|
default: true
|
|
gem_path:
|
|
type: path
|
|
description:
|
|
- Only applies if O(state=present). Specifies the directory to install the gems into. If O(chdir) is set then this path
|
|
is relative to O(chdir).
|
|
- If not specified the default RubyGems gem paths will be used.
|
|
binstub_directory:
|
|
type: path
|
|
description:
|
|
- Only applies if O(state=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. If O(chdir)
|
|
is set then this path is relative to O(chdir).
|
|
extra_args:
|
|
type: str
|
|
description:
|
|
- A space separated string of additional commands that can be applied to the Bundler command. Refer to the Bundler documentation
|
|
for more information.
|
|
author: "Tim Hoiberg (@thoiberg)"
|
|
"""
|
|
|
|
EXAMPLES = r"""
|
|
- name: Install gems from a Gemfile in the current directory
|
|
community.general.bundler:
|
|
state: present
|
|
executable: ~/.rvm/gems/2.1.5/bin/bundle
|
|
|
|
- name: Exclude the production group from installing
|
|
community.general.bundler:
|
|
state: present
|
|
exclude_groups: production
|
|
|
|
- name: Install gems into ./vendor/bundle
|
|
community.general.bundler:
|
|
state: present
|
|
deployment_mode: true
|
|
|
|
- name: Install gems using a Gemfile in another directory
|
|
community.general.bundler:
|
|
state: present
|
|
gemfile: ../rails_project/Gemfile
|
|
|
|
- name: Update Gemfile in another directory
|
|
community.general.bundler:
|
|
state: latest
|
|
chdir: ~/rails_project
|
|
"""
|
|
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
|
|
|
|
def get_bundler_executable(module):
|
|
if module.params.get('executable'):
|
|
result = module.params.get('executable').split(' ')
|
|
else:
|
|
result = [module.get_bin_path('bundle', True)]
|
|
return result
|
|
|
|
|
|
def main():
|
|
module = AnsibleModule(
|
|
argument_spec=dict(
|
|
executable=dict(default=None, required=False),
|
|
state=dict(default='present', required=False, choices=['present', 'latest']),
|
|
chdir=dict(default=None, required=False, type='path'),
|
|
exclude_groups=dict(default=None, required=False, type='list', elements='str'),
|
|
clean=dict(default=False, required=False, type='bool'),
|
|
gemfile=dict(default=None, required=False, type='path'),
|
|
local=dict(default=False, required=False, type='bool'),
|
|
deployment_mode=dict(default=False, required=False, type='bool'),
|
|
user_install=dict(default=True, required=False, type='bool'),
|
|
gem_path=dict(default=None, required=False, type='path'),
|
|
binstub_directory=dict(default=None, required=False, type='path'),
|
|
extra_args=dict(default=None, required=False),
|
|
),
|
|
supports_check_mode=True
|
|
)
|
|
|
|
state = module.params.get('state')
|
|
chdir = module.params.get('chdir')
|
|
exclude_groups = module.params.get('exclude_groups')
|
|
clean = module.params.get('clean')
|
|
gemfile = module.params.get('gemfile')
|
|
local = module.params.get('local')
|
|
deployment_mode = module.params.get('deployment_mode')
|
|
user_install = module.params.get('user_install')
|
|
gem_path = module.params.get('gem_path')
|
|
binstub_directory = module.params.get('binstub_directory')
|
|
extra_args = module.params.get('extra_args')
|
|
|
|
cmd = get_bundler_executable(module)
|
|
|
|
if module.check_mode:
|
|
cmd.append('check')
|
|
rc, out, err = module.run_command(cmd, cwd=chdir, check_rc=False)
|
|
|
|
module.exit_json(changed=rc != 0, state=state, stdout=out, stderr=err)
|
|
|
|
if state == 'present':
|
|
cmd.append('install')
|
|
if exclude_groups:
|
|
cmd.extend(['--without', ':'.join(exclude_groups)])
|
|
if clean:
|
|
cmd.append('--clean')
|
|
if gemfile:
|
|
cmd.extend(['--gemfile', gemfile])
|
|
if local:
|
|
cmd.append('--local')
|
|
if deployment_mode:
|
|
cmd.append('--deployment')
|
|
if not user_install:
|
|
cmd.append('--system')
|
|
if gem_path:
|
|
cmd.extend(['--path', gem_path])
|
|
if binstub_directory:
|
|
cmd.extend(['--binstubs', binstub_directory])
|
|
else:
|
|
cmd.append('update')
|
|
if local:
|
|
cmd.append('--local')
|
|
|
|
if extra_args:
|
|
cmd.extend(extra_args.split(' '))
|
|
|
|
rc, out, err = module.run_command(cmd, cwd=chdir, check_rc=True)
|
|
|
|
module.exit_json(changed='Installing' in out, state=state, stdout=out, stderr=err)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|