Default variable details

Some of debops.apt_mark default variables have more extensive configuration than simple strings or lists, here you can find documentation and examples for them.

apt_mark__packages

The apt_mark__*_packages list variables specify the desired state of the APT packages to set on the hosts. Only already installed APT packages are managed. Each list entry is a YAML dictionary with specific parameters:

name
Required. Name of an APT package to configure. At the moment the role does not support usage of glob patterns (eg. package-*).
packages
Optional. A list of APT packages to manage. If specified, the name parameter is ignored. Glob patterns are not supported.
state

Optional. This parameter defines what state to set for the specified package(s) The available states:

  auto manual
hold auto-hold manual-hold
unhold auto-unhold manual-unhold

If not specified, manual state is set by default, hold state is not changed. You can find out more about these states in the apt-mark(8) manual page.

Examples

Mark a package as installed manually, so it won't be autoremoved:

apt_mark__packages:

  - name: 'zsh'

  - name: 'bash'
    state: 'manual'

Mark multiple installed packages as installed manually and held in their current state. Only the packages already installed will be affected:

apt_mark__packages:

  - name: 'nginx-packages'
    state: 'manual-hold'
    packages:
      - 'nginx'
      - 'nginx-common'
      - 'nginx-extras'