community.general.locale_gen 模块 – 创建或删除区域设置

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.locale_gen。

概要 

通过编辑 /etc/locale.gen 并调用 locale-gen 来管理区域设置。

参数 

参数	注释
名称 list / elements=string / required	区域设置的名称和编码，例如 `en_GB.UTF-8`。在 community.general 9.3.0 之前，这是一个字符串。使用字符串仍然有效。
状态 string	区域设置是否应存在。选择 `"absent"` `"present"` ← (默认)

属性 

属性	支持	描述
check_mode	支持: 完全	可以在 `check_mode` 中运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持: 无	当处于 diff 模式时，将返回有关已更改的内容（或在 `check_mode` 中可能需要更改的内容）的详细信息。

注意 

注意

此模块不支持基于 RHEL 的系统。

示例 

- name: Ensure a locale exists
  community.general.locale_gen:
    name: de_CH.UTF-8
    state: present

- name: Ensure multiple locales exist
  community.general.locale_gen:
    name:
      - en_GB.UTF-8
      - nl_NL.UTF-8
    state: present

作者

Augustus Kling (@AugustusKling)