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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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
Необходимо предварительно войти в Mac App Store с Apple ID, который будет использоваться (проверьте с помощью mas account).
Для пользователей macOS 12.0 и выше отключена функция проверки входа пользователя.
Пользователям macOS 12.0 и выше необходимо предварительно войти в графический интерфейс Mac App Store из-за https://github.com/mas-cli/mas/issues/417.

Параметры

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

Атрибуты

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

Примеры

- 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/mas_module.html