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'