community.general.homebrew – Управляющий пакетами Homebrew
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: 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" | Список путей, разделённых двоеточием, для поиска исполняемого файла '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 (C(/usr/local/bin))
- 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'] |
Авторы
- Индраджит Райчаудхури (@indrajitr)
- Даниэль Жауэн (@danieljaouen)
- Эндрю Данхэм (@andrew-d)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/homebrew_module.html