Модуль community.general.bundler — управление зависимостями Ruby Gem с помощью Bundler

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.bundler.

Краткое описание
Параметры
Атрибуты
Примеры

Краткое описание

Управление установкой и зависимостями от версий Gem для Ruby с помощью Gem Bundler.

Параметры

Параметр	Комментарии
binstub_directory path	Применяется только если задано `state=present`. Указывает каталог для установки файлов исполняемых файлов gem. При запуске эти файлы выполняются в контексте Gemfile и завершаются с ошибкой, если какие-либо необходимые зависимости gem не установлены. Если задано `chdir`, этот путь считается относительным к `chdir`.
chdir path	Каталог, из которого выполняются команды bundler. В этом каталоге должен находиться корректный Gemfile или каталог .bundle/. Если параметр не указан, используется временный рабочий каталог.
clean boolean	Применяется только если задано `state=present`. Если установлено, удаляет с целевого узла все gem, которых нет в Gemfile. Варианты: `false` ← (по умолчанию) `true`
deployment_mode boolean	Применяется только если задано `state=present`. Если установлено, устанавливает gem в `./vendor/bundle` вместо расположения по умолчанию. Перед этим необходимо создать файл `Gemfile.lock`. Варианты: `false` ← (по умолчанию) `true`
exclude_groups list / elements=string	Список групп Gemfile, которые необходимо исключить при выполнении операций. Применяется только если задано `state=present`. Bundler считает это «сохранённым» свойством Gemfile и автоматически исключает группы при последующих операциях, даже если `exclude_groups` не задано.
executable string	Путь к исполняемому файлу bundler.
extra_args string	Строка дополнительных команд, разделённых пробелами, которые можно передать команде Bundler. Дополнительные сведения см. в документации Bundler.
gem_path path	Применяется только если задано `state=present`. Указывает каталог для установки gem. Если задано `chdir`, этот путь считается относительным к `chdir`. Если параметр не указан, используются пути RubyGems по умолчанию.
gemfile path	Применяется только если задано `state=present`. Путь к Gemfile, который будет использоваться для установки gem. Если параметр не указан, используется Gemfile из текущего каталога.
local boolean	Если установлено, gem устанавливаются только из кэша на целевом узле. Варианты: `false` ← (по умолчанию) `true`
state string	Требуемое состояние пакета Gem. `latest` обновляет gem до последней допустимой версии. Варианты: `"present"` ← (по умолчанию) `"latest"`
user_install boolean	Применяется только если задано `state=present`. Устанавливает gem в локальный кэш пользователя или для всех пользователей. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой узел.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примеры

- 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

Авторы

Tim Hoiberg (@thoiberg)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/bundler_module.html