ansible.builtin.debconf 模块 – 配置 .deb 包

注意

此模块是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，即使不指定 collections 关键字，您也可以使用简短的模块名称 debconf。但是，我们建议您使用完全限定的集合名称 (FQCN) ansible.builtin.debconf，以便轻松链接到模块文档并避免与可能具有相同模块名称的其他集合发生冲突。

概要 

使用 debconf-set-selections 配置 .deb 包。
或者只查询现有选择。

要求 

以下要求在执行此模块的主机上是必需的。

debconf
debconf-utils

参数 

参数	注释
name 别名: pkg 字符串 / 必需	要配置的包的名称。
question 别名: selection, setting 字符串	一个 debconf 配置设置。
unseen 布尔值	在预播种时不设置 `seen` 标志。选择 `false` ← (默认) `true`
value 别名: answer 任何	要设置的配置值。在 Ansible 2.17 之后，`value` 的类型为 `raw`。
vtype 字符串	提供的值的类型。强烈建议在指定 `vtype=password` 时向任务添加 `no_log=True`。 `seen` 在 Ansible 2.2 中添加。在 Ansible 2.17 之后，如果 `vtype` 设置为 `multiselect`，用户可以将 `value` 指定为列表。选择 `"布尔值"` `"错误"` `"multiselect"` `"注意"` `"密码"` `"已查看"` `"选择"` `"字符串"` `"文本"` `"标题"`

属性 

属性	支持	描述
check_mode	支持: 完全支持	可以在 check_mode 下运行并返回更改状态预测，而无需修改目标，如果不支持，则将跳过操作。
diff_mode	支持: 完全支持	将在 diff 模式下返回有关已更改内容（或可能在 check_mode 中需要更改的内容）的详细信息
platform	平台: debian	可以对其进行操作的目标操作系统/系列

备注 

注意

此模块需要命令行 debconf 工具。
必须回答几个问题（取决于包）。在任何已安装该包的 Debian 或衍生版本上使用“debconf-show <package>”，查看可用的问题/设置。
某些发行版将始终将涉及设置密码的任务记录为已更改。这是因为 debconf-get-selections 会屏蔽密码。
强烈建议在使用此模块处理敏感信息时向任务添加 no_log=True。
ansible.builtin.debconf 模块不会重新配置包，它只是更新 debconf 数据库。需要额外的步骤（通常使用 notify 如果 debconf 做出更改）来重新配置包并应用更改。 debconf 广泛用于安装前的预播种配置，而不是修改配置。因此，虽然 dpkg-reconfigure 使用 debconf 数据，但它并不总是权威的，您可能需要检查您的包是如何处理的。
另请注意 dpkg-reconfigure 是一个三阶段过程。它使用 <package>.prerm reconfigure <version>、<package>.config reconfigure <version> 和 <package>.postinst control <version> 参数从 /var/lib/dpkg/info 目录调用控制脚本。
主要问题是，许多包的 <package>.config reconfigure 步骤将首先通过检查磁盘上的配置来重置 debconf 数据库（覆盖此模块所做的更改）。如果您的包是这种情况，那么 dpkg-reconfigure 将有效地忽略 debconf 做出的更改。
但是，由于 dpkg-reconfigure 仅在文件存在时才执行 <package>.config 步骤，因此可以在执行 dpkg-reconfigure -f noninteractive <package> 之前将其重命名为 /var/lib/dpkg/info/<package>.config.ignore，然后将其恢复。这似乎符合 Debian 关于 .config 文件的策略。

示例 

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

- name: Set to generate locales
  ansible.builtin.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
  ansible.builtin.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
  ansible.builtin.debconf:
    name: tzdata

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

作者

Brian Coca (@bcoca)