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 |
| Do not set 'seen' flag when pre-seeding. |
value string | Value to set the configuration to. aliases: answer | |
vtype string |
| 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 <package>’ 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
- This module is guaranteed to have no backward incompatible interface changes going forward. [stableinterface]
- This module is maintained by the Ansible Core Team. [core]
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