Модуль community.general.homebrew — менеджер пакетов для Homebrew

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 list / элементы=string	Флаги параметров для установки пакета.
name псевдонимы: formula, package, pkg list / элементы=string	Список названий пакетов для установки или удаления.
path path	Список путей, разделённых `:`, для поиска исполняемого файла `brew`. Поскольку расположение пакета (формулы в терминологии homebrew) определяется относительно фактического пути команды `brew`, указание альтернативного пути `brew` позволяет управлять другим набором пакетов в альтернативном расположении в системе. По умолчанию: `"/usr/local/bin:/opt/homebrew/bin:/home/linuxbrew/.linuxbrew/bin"`
state string	Состояние пакета. Варианты: `"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 list / элементы=string добавлено в community.general 0.2.0	Флаги параметров для обновления.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: full	Можно запускать в режиме `check_mode` и возвращать прогноз изменения состояния без внесения изменений в целевую систему.
diff_mode	Поддержка: none	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `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 list / элементы=string добавлено в community.general 0.2.0	Список названий пакетов, изменившихся после выполнения модуля. Возвращается: success Пример: `["git", "git-cola"]`
msg string	Был ли обновлён кэш. Возвращается: always Пример: `"Changed: 0, Unchanged: 2"`
unchanged_pkgs list / элементы=string добавлено в community.general 0.2.0	Список названий пакетов, не изменившихся после выполнения модуля. Возвращается: success Пример: `["awscli", "ag"]`

Авторы

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

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

© 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/homebrew_module.html