Модуль community.general.homebrew – Управление пакетами Homebrew

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.

Для использования в плейбуке укажите: community.general.homebrew.

Описание
Требования
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Описание

Управление пакетами Homebrew

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

На целевой системе должен быть предварительно установлен homebrew

Параметры

Параметр	Комментарии
force_formula boolean добавлено в community.general 9.0.0	Принудительно обрабатывать пакет(ы) как формулу (эквивалентно `brew --formula`). Для установки cask используйте модуль community.general.homebrew_cask. Варианты: `false` ← (по умолчанию) `true`
install_options псевдонимы: options список / элементы=строка	Флаги параметров для установки пакета.
name псевдонимы: formula, package, pkg список / элементы=строка	Список имён пакетов для установки/удаления.
path путь	Список путей, разделённых `:`, для поиска исполняемого файла `brew`. Поскольку расположение пакета (формула в терминологии homebrew) указывается относительно фактического пути к команде `brew`, предоставление альтернативного `brew` пути позволяет управлять различными наборами пакетов в альтернативной системной папке. По умолчанию: `"/usr/local/bin:/opt/homebrew/bin:/home/linuxbrew/.linuxbrew/bin"`
state строка	Состояние пакета. Варианты: `"absent"` `"head"` `"installed"` `"latest"` `"linked"` `"present"` ← (по умолчанию) `"removed"` `"uninstalled"` `"unlinked"` `"upgraded"`
update_homebrew boolean	Сначала обновить сам homebrew. Варианты: `false` ← (по умолчанию) `true`
upgrade_all псевдонимы: upgrade boolean	Обновить все пакеты homebrew. Варианты: `false` ← (по умолчанию) `true`
upgrade_options список / элементы=строка добавлено в community.general 0.2.0	Флаги параметров для обновления.

Атрибуты

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

Примечания

Примечание

При использовании с loop: каждый пакет будет обрабатываться индивидуально. Гораздо эффективнее передать список напрямую в параметр name.

Примеры

# Install formula foo with 'brew' in default path
- community.general.homebrew:
    name: foo
    state: present

# Install formula foo with 'brew' in alternate path (/my/other/location/bin)
- community.general.homebrew:
    name: foo
    path: /my/other/location/bin
    state: present

# Update homebrew first and install formula foo with 'brew' in default path
- community.general.homebrew:
    name: foo
    state: present
    update_homebrew: true

# Update homebrew first and upgrade formula foo to latest available with 'brew' in default path
- community.general.homebrew:
    name: foo
    state: latest
    update_homebrew: true

# Update homebrew and upgrade all packages
- community.general.homebrew:
    update_homebrew: true
    upgrade_all: true

# Miscellaneous other examples
- community.general.homebrew:
    name: foo
    state: head

- community.general.homebrew:
    name: foo
    state: linked

- community.general.homebrew:
    name: foo
    state: absent

- community.general.homebrew:
    name: foo,bar
    state: absent

- community.general.homebrew:
    name: foo
    state: present
    install_options: with-baz,enable-debug

- name: Install formula foo with 'brew' from cask
  community.general.homebrew:
    name: homebrew/cask/foo
    state: present

- name: Use ignore-pinned option while upgrading all
  community.general.homebrew:
    upgrade_all: true
    upgrade_options: ignore-pinned

- name: Force installing a formula whose name is also a cask name
  community.general.homebrew:
    name: ambiguous_formula
    state: present
    force_formula: true

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Описание
changed_pkgs список / элементы=строка добавлен в community.general 0.2.0	Список имён пакетов, которые были изменены после выполнения модуля Возвращается: успешно Пример: `["git", "git-cola"]`
msg строка	если кэш был обновлён или нет Возвращается: всегда Пример: `"Changed: 0, Unchanged: 2"`
unchanged_pkgs список / элементы=строка добавлен в community.general 0.2.0	Список имён пакетов, которые не были изменены после выполнения модуля Возвращается: успешно Пример: `["awscli", "ag"]`

Авторы

Indrajit Raychaudhuri (@indrajitr)
Daniel Jaouen (@danieljaouen)
Andrew Dunham (@andrew-d)

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

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