Copyright (C) 2024 Maciej Delmanowski <drybjed@gmail.com> Copyright (C) 2024 DebOps <https://debops.org/> SPDX-License-Identifier: GPL-3.0-or-later

debops.debconf default variables

The debconf configuration database

Variables which define what configuration entries should be set in the Debconf database. See debconf__entries for more details.

debconf__entries

List of Debconf database entries to set on all hosts in the Ansible inventory.

debconf__entries: []

debconf__group_entries

List of Debconf database entries to set on hosts in a specific Ansible inventory group.

debconf__group_entries: []

debconf__host_entries

List of Debconf database entries to set on specific hosts in the Ansible inventory.

debconf__host_entries: []

debconf__combined_entries

Variable which combines all other Debconf database entry lists and is used as an input for the configuration filtering template.

debconf__combined_entries: '{{ debconf__entries
                                  + debconf__group_entries
                                  + debconf__host_entries }}'

debconf__filtered_entries

Variable that contains the output of the template that filters the configuration of the Debconf database entries and is used in role tasks and templates.

debconf__filtered_entries: '{{ lookup("template",
                                     "lookup/debconf__filtered_entries.j2",
                                     convert_data=False) | from_yaml }}'

APT package installation

debconf__apt_state

Specify the state of the APT packages installed by the debops.debconf role. Either present (packages will be installed but not upgraded) or latest (packages will be installed or upgraded if already present). It's best to use this variable on the command line to avoid issues with idempotency.

debconf__apt_state: 'present'

debconf__packages

List of APT packages which should be installed by the debops.debconf role on all hosts in the Ansible inventory.

debconf__packages: []

debconf__group_packages

List of APT packages which should be installed by the debops.debconf role on hosts in a specific Ansible inventory group.

debconf__group_packages: []

debconf__host_packages

List of APT packages which should be installed by the debops.debconf role on specific hosts in the Ansible inventory.

debconf__host_packages: []

Alternative package symlinks

These lists can be used to define alternative symlinks for certain packages which provide similar functionality, using update-alternatives package. See debconf__alternatives for more details.

debconf__alternatives

List of symlink configuration entries defined on all hosts in the Ansible inventory.

debconf__alternatives: []

debconf__group_alternatives

List of symlink configuration entries defined on hosts in a specific Ansible inventory group.

debconf__group_alternatives: []

debconf__host_alternatives

List of symlink configuration entries defined on specific hosts in the Ansible inventory.

debconf__host_alternatives: []

Custom shell commands

The variables below let you define shell commands (or even small shell scripts) to execute on the remote hosts as the root UNIX account. You need to ensure idempotency by yourself. This is not a replacement for a normal Ansible role.

See debconf__commands for more details.

debconf__commands

List of shell commands which should be executed on all hosts in the Ansible inventory.

debconf__commands: []

debconf__group_commands

List of shell commands which should be executed on hosts in a specific Ansible inventory group.

debconf__group_commands: []

debconf__host_commands

List of shell commands which should be executed on specific hosts in the Ansible inventory.

debconf__host_commands: []

debconf__combined_commands

Variable which combines all other shell command variables and is used in the role tasks.

debconf__combined_commands: '{{ debconf__commands
                                   + debconf__group_commands
                                   + debconf__host_commands }}'