community.general.homebrew – Управляющий пакетами Homebrew
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.homebrew.
Обзор
- Управление пакетами Homebrew
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- Homebrew должен быть установлен на целевой системе
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| install_options список / элементы=строка | флаги параметров для установки пакета. псевдонимы: options | |
| name список / элементы=строка | Список имён пакетов для установки/удаления. псевдонимы: formula, package, pkg | |
| path путь | По умолчанию: "/usr/local/bin:/opt/homebrew/bin" | Список путей для поиска исполняемого файла 'brew', разделённый двоеточием. Поскольку расположение пакета (формула в терминологии homebrew) задаётся относительно фактического пути к команде 'brew', предоставление альтернативного пути 'brew' позволяет управлять разными наборами пакетов в альтернативном расположении в системе. |
| state строка |
| Состояние пакета. |
| update_homebrew логическое значение |
| Обновить сам Homebrew. псевдонимы: update-brew |
| upgrade_all логическое значение |
| Обновить все пакеты Homebrew. псевдонимы: upgrade |
| upgrade_options список / элементы=строка добавлено в 0.2.0 community.general | Флаги параметров для обновления. |
Примечания
Примечание
- При использовании с
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 C(/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: yes
# Update homebrew first and upgrade formula foo to latest available with 'brew' in default path
- community.general.homebrew:
name: foo
state: latest
update_homebrew: yes
# Update homebrew and upgrade all packages
- community.general.homebrew:
update_homebrew: yes
upgrade_all: yes
# 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: Use ignored-pinned option while upgrading all
community.general.homebrew:
upgrade_all: yes
upgrade_options: ignored-pinned
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| changed_pkgs список / элементы=строка добавлено в 0.2.0 community.general | успех | Список имён пакетов, изменённых после выполнения модуля Пример: ['git', 'git-cola'] |
| msg строка | всегда | была ли обновлена кэш Пример: Изменено: 0, Не изменено: 2 |
| unchanged_pkgs список / элементы=строка добавлено в 0.2.0 community.general | успех | Список имён пакетов, которые не были изменены после выполнения модуля Пример: ['awscli', 'ag'] |
Авторы
- Indrajit Raychaudhuri (@indrajitr)
- Daniel Jaouen (@danieljaouen)
- Andrew Dunham (@andrew-d)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/homebrew_module.html