Модуль community.general.snap – Управление пакетами snap

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general.

Для использования в playbook, укажите: community.general.snap.

Краткое описание
Параметры
Атрибуты
См. также
Примеры
Возвращаемые значения

Краткое описание

Управляет пакетами snap.

Параметры

Параметр	Комментарии
channel string	Определяет, какой релиз snap установлен и отслеживается на предмет обновлений. Этот параметр может быть указан только в случае, если в задаче есть один snap. Если не указан, команда `snap` будет по умолчанию использовать `stable`. Если переданное значение не содержит `track`, оно будет по умолчанию установлено в `latest`. Например, если передано `edge`, модуль будет предполагать, что канал равен `latest/edge`. См. https://snapcraft.io/docs/channels для получения более подробной информации о каналах snap.
classic boolean	Политика изоляции. Классическая изоляция позволяет snap иметь тот же уровень доступа к системе, что и «классические» пакеты, такие как пакеты, управляемые APT. Этот параметр соответствует аргументу `--classic`. Этот параметр может быть указан только в случае, если в задаче есть один snap. Варианты: `false` ← (по умолчанию) `true`
dangerous boolean добавлено в community.general 7.2.0	Установить заданный файл snap, даже если для него нет предварительно подтвержденных подписей, то есть он не был проверен и может быть опасен. Варианты: `false` ← (по умолчанию) `true`
name list / elements=string / required	Имя пакетов snap, которые нужно установить. Любой пакет snap, принимаемый командой `snap`, является допустимым. Обратите внимание, что файлы snap могут потребовать `dangerous=true` для игнорирования ошибки «cannot find signatures with metadata for snap».
options list / elements=string добавлено в community.general 4.4.0	Установить параметры с шаблоном `key=value` или `snap:key=value`. Если указано имя snap, параметр будет применен только к этому snap. Если имя snap опущено, параметры будут применены ко всем snap, перечисленным в `name`. Параметры будут применены только к активным snap.
state string	Требуемое состояние пакета. Когда `state=present`, модуль будет использовать `snap install`, если snap не установлен, и `snap refresh`, если он установлен, но из другого канала. Варианты: `"absent"` `"present"` ← (по умолчанию) `"enabled"` `"disabled"`

Атрибуты

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

См. также

community.general.snap_alias: Управляет псевдонимами snap.

Примеры

# Install "foo" and "bar" snap
- name: Install foo
  community.general.snap:
    name:
      - foo
      - bar

# Install "foo" snap with options par1=A and par2=B
- name: Install "foo" with options
  community.general.snap:
    name:
      - foo
    options:
      - par1=A
      - par2=B

# Install "foo" and "bar" snaps with common option com=A and specific options fooPar=X and barPar=Y
- name: Install "foo" and "bar" with options
  community.general.snap:
    name:
      - foo
      - bar
    options:
      - com=A
      - foo:fooPar=X
      - bar:barPar=Y

# Remove "foo" snap
- name: Remove foo
  community.general.snap:
    name: foo
    state: absent

# Install a snap with classic confinement
- name: Install "foo" with option --classic
  community.general.snap:
    name: foo
    classic: true

# Install a snap with from a specific channel
- name: Install "foo" with option --channel=latest/edge
  community.general.snap:
    name: foo
    channel: latest/edge

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Описание
channel строка	Канал, из которого были установлены снимки Возвращается: При установке снимков
classic логическое	Установлены ли снимки с классическим ограничением Возвращается: При установке снимков
cmd строка	Команда, выполненная на хосте Возвращается: Когда changed равно true
options_changed список / элементы=строка добавлено в community.general 4.4.0	Список настроек, изменённых/установленных в формате `snap:key=value`. Возвращается: При изменении/установке любых параметров
snaps_installed список / элементы=строка	Список фактически установленных снимков Возвращается: При установке любых снимков
snaps_removed список / элементы=строка	Список фактически удалённых снимков Возвращается: При удалении любых снимков

Авторы

Victor Carceler (@vcarceler)
Stanislas Lange (@angristan)

Ссылки на сборку

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