Модуль community.general.mas – Управление приложениями из Mac App Store с помощью mas-cli

Примечание

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

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

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

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

Добавлено в community.general 0.2.0

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

Описание

Устанавливает, удаляет и обновляет приложения macOS из Mac App Store с помощью mas-cli.

Требования

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

macOS 10.11+
mas-cli (https://github.com/mas-cli/mas) 1.5.0+ доступен как mas в пути bin
Apple ID для использования уже должен быть авторизован в Mac App Store (проверьте с помощью mas account).
Функция проверки авторизации пользователя отключена для всех пользователей macOS 12.0+.
Для пользователей macOS 12.0+ необходимо предварительно войти в систему через графический интерфейс Mac App Store из-за https://github.com/mas-cli/mas/issues/417.

Параметры

Параметр	Комментарии
id список / элементы=целое число	Идентификатор приложения Mac App Store, которое(ые) вы хотите управлять. Его можно найти, выполнив `mas search APP_NAME` на вашей машине.
state строка	Желаемое состояние установки приложения. Значение `absent` требует прав root, также см. примеры. Варианты: `"absent"` `"latest"` `"present"` ← (по умолчанию)
upgrade_all псевдонимы: upgrade логический	Обновить все установленные приложения из Mac App Store. Варианты: `false` ← (по умолчанию) `true`

Атрибуты

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

Примеры

- name: Install Keynote
  community.general.mas:
    id: 409183694
    state: present

- name: Install Divvy with command mas installed in /usr/local/bin
  community.general.mas:
    id: 413857545
    state: present
  environment:
    PATH: /usr/local/bin:{{ ansible_facts.env.PATH }}

- name: Install a list of apps
  community.general.mas:
    id:
      - 409183694 # Keynote
      - 413857545 # Divvy
    state: present

- name: Ensure the latest Keynote version is installed
  community.general.mas:
    id: 409183694
    state: latest

- name: Upgrade all installed Mac App Store apps
  community.general.mas:
    upgrade_all: true

- name: Install specific apps and also upgrade all others
  community.general.mas:
    id:
      - 409183694 # Keynote
      - 413857545 # Divvy
    state: present
    upgrade_all: true

- name: Uninstall Divvy
  community.general.mas:
    id: 413857545
    state: absent
  become: true # Uninstallation requires root permissions

Авторы

Michael Heap (@mheap)
Lukas Bestle (@lukasbestle)

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

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