Модуль community.general.snap — управление снапами

Примечание

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

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

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

Чтобы использовать коллекцию в плейбуке, укажите: community.general.snap.

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

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

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

Параметры

Параметр	Комментарии
channel string	Указывает, какой выпуск snap устанавливается и отслеживается для получения обновлений. Этот параметр можно указать, только если в задаче указан один snap. Если параметр не указан, команда `snap` по умолчанию использует `stable`. Если переданное значение не содержит `track`, по умолчанию используется `latest`. Например, если передано `edge`, модуль считает, что канал — `latest/edge`. Дополнительные сведения о каналах snap см. на странице https://snapcraft.io/docs/channels.
classic boolean	Устанавливает snap с классическим режимом изоляции. Этот параметр соответствует аргументу `--classic` команды `snap install`. Этот режим изоляции является разрешительным: он предоставляет полный доступ к системе, подобно традиционно упакованным приложениям, которые не используют механизмы изоляции. Этот параметр можно указать, только если задача включает один snap. Дополнительные сведения о классическом режиме изоляции и уровнях изоляции см. на странице https://snapcraft.io/docs/snap-confinement. Варианты: `false` ← (по умолчанию) `true`
dangerous boolean добавлено в community.general 7.2.0	Устанавливает snap в опасном режиме, не проверяя его утверждения и подписи. Это полезно при установке локальных snap, которые не имеют подписи либо имеют подписи, которые не были подтверждены. Дополнительные сведения о режимах установки см. на странице https://snapcraft.io/docs/install-modes. Варианты: `false` ← (по умолчанию) `true`
name list / элементы=string / обязательный	Имя устанавливаемых snap. Допустимо любое имя snap, принимаемое командой `snap`. При установке файлов `.snap` может потребоваться `dangerous=true`. Дополнительные сведения см. в `dangerous`.
options list / элементы=string добавлено в community.general 4.4.0	Задаёт параметры в формате `key=value` или `snap:key=value`. Если указано имя snap, параметр применяется только к этому snap. Если имя snap не указано, параметры применяются ко всем snap из списка `name`. Параметры применяются только к активным snap. Параметры применяются только при значении `present` для `state`. Это выполняется после необходимой установки или обновления (повышения/понижения версии) всех snap из списка `name`. Дополнительные сведения о параметрах конфигурации snap см. на странице https://snapcraft.io/docs/configuration-in-snaps.
state string	Требуемое состояние пакета. При значении `state=present` модуль использует `snap install`, если snap не установлен, и `snap refresh`, если snap установлен, но из другого канала. Варианты: `"absent"` `"present"` ← (по умолчанию) `"enabled"` `"disabled"`

Атрибуты

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

Примечания

Примечание

Для операций с повышенными привилегиями, например установки и настройки snap, требуются права root. Это необходимо только в том случае, если пользователь не выполнил вход в Snap Store.

См. также

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 string	Канал, из которого были установлены snap. Возвращается: при установке snap
classic boolean	Указывает, были ли snap установлены с классическим режимом изоляции. Возвращается: при установке snap
cmd string	Команда, выполненная на узле. Возвращается: если значение changed равно true
options_changed list / элементы=string добавлено в community.general 4.4.0	Список заданных/изменённых параметров в формате `snap:key=value`. Возвращается: если какие-либо параметры были изменены/заданы
snaps_installed list / элементы=string	Список фактически установленных snap. Возвращается: если были установлены какие-либо snap
snaps_removed list / элементы=string	Список фактически удалённых snap. Возвращается: если были удалены какие-либо snap
version dictionary добавлено в community.general 10.3.0	Версии компонентов snap, указанные командой `snap version`. Возвращается: всегда

Авторы

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

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

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