Documentation

snap – Manages snaps

New in version 2.8.

Synopsis

  • Manages snaps packages.

Parameters

Parameter Choices/Defaults Comments
channel
string
Default:
"stable"
Define which release of a snap is installed and tracked for updates. This option can only be specified if there is a single snap in the task.
classic
boolean
    Choices:
  • no ←
  • yes
Confinement policy. The classic confinment allows a snap to have the same level of access to the system as "classic" packages, like those managed by APT. This option corresponds to the --classic argument. This option can only be specified if there is a single snap in the task.
name
- / required
Name of the snap to install or remove. Can be a list of snaps.
state
-
    Choices:
  • absent
  • present ←
Desired state of the package.

Examples

# Install "foo" and "bar" snap
- name: Install foo
  snap:
    name:
      - foo
      - bar

# Remove "foo" snap
- name: Remove foo
  snap:
    name: foo
    state: absent

# Install a snap with classic confinement
- name: Install "foo" with option --classic
  snap:
    name: foo
    classic: yes

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

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
channel
string
When snaps are installed
The channel the snaps were installed from

classic
boolean
When snaps are installed
Whether or not the snaps were installed with the classic confinement

cmd
string
When changed is true
The command that was executed on the host

snaps_installed
list
When any snaps have been installed
The list of actually installed snaps

snaps_removed
list
When any snaps have been removed
The list of actually removed snaps



Status

Authors

Hint

If you notice any issues in this documentation you can edit this document to improve it.