debconf – Configure a .deb package

From Get docs
Ansible/docs/2.8/modules/debconf module


debconf – Configure a .deb package

Synopsis

  • Configure a .deb package using debconf-set-selections.
  • Or just query existing selections.

Requirements

The below requirements are needed on the host that executes this module.

  • debconf
  • debconf-utils

Parameters

Parameter Choices/Defaults Comments

name

string / required

Name of package to configure.


aliases: pkg

question

string

A debconf configuration setting.


aliases: selection, setting

unseen

boolean

  • no

  • yes

Do not set 'seen' flag when pre-seeding.

value

string

Value to set the configuration to.


aliases: answer

vtype

string

  • boolean
  • error
  • multiselect
  • note
  • password
  • seen
  • select
  • string
  • text
  • title

The type of the value supplied.

It is highly recommended to add no_log=True to task while specifying vtype=password.

seen was added in Ansible 2.2.



Notes

Note

  • This module requires the command line debconf tools.
  • A number of questions have to be answered (depending on the package). Use ‘debconf-show ’ on any Debian or derivative with the package installed to see questions/settings available.
  • Some distros will always record tasks involving the setting of passwords as changed. This is due to debconf-get-selections masking passwords.
  • It is highly recommended to add no_log=True to task while handling sensitive information using this module.


Examples

- name: Set default locale to fr_FR.UTF-8
  debconf:
    name: locales
    question: locales/default_environment_locale
    value: fr_FR.UTF-8
    vtype: select

- name: Set to generate locales
  debconf:
    name: locales
    question: locales/locales_to_be_generated
    value: en_US.UTF-8 UTF-8, fr_FR.UTF-8 UTF-8
    vtype: multiselect

- name: Accept oracle license
  debconf:
    name: oracle-java7-installer
    question: shared/accepted-oracle-license-v1-1
    value: 'true'
    vtype: select

- name: Specifying package you can register/return the list of questions and current values
  debconf:
    name: tzdata

- name: Pre-configure tripwire site passphrase
  debconf:
    name: tripwire
    question: tripwire/site-passphrase
    value: "{{ site_passphrase }}"
    vtype: password
  no_log: True

Status

Red Hat Support

More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.

Authors

  • Brian Coca (@bcoca)

Hint

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


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/debconf_module.html